3D Secure Authentication

Authentication is a tool that reduces fraud. With authentication, you can verify the identity of the payer, typically through a combination of usernames, passwords, and other personal identification methods. Its primary purpose is to protect against fraudulent activities by confirming that the person who is initiating the transaction is the cardholder or the account holder. The gateway supports 3D Secure authentication.


PUT/merchant/{merchantId}/order/{orderid}/transaction/{transactionid}

Authenticate Payer

Request to authenticate a payer, i.e. verify the identity of a cardholder. You can subsequently use the resulting authentication data when submitting a financial transaction request to prove that you have performed payer authentication.

Request Parameters

Required Properties for a simple request.

  • Name
    apiOperation
    Type
    string Required
    Description
    AUTHENTICATE_PAYER
  • Name
    order
    Type
    object Required
    Description
    Information about the order associated with this transaction.

Response Parameters

Required Properties for a simple request.

  • Name
    merchant
    Type
    string
    Description
    The unique identifier issued to you by your payment provider.
  • Name
    order
    Type
    object
    Description
    Information about the order associated with this transaction.
  • Name
    response
    Type
    object
    Description
  • Name
    result
    Type
    enum
    Description
    A system-generated high-level overall result of the operation.
    Enum Options:
    FAILUREPENDINGSUCCESSUNKNOWN
  • Name
    transaction
    Type
    object
    Description
    Information about this transaction.

PUT/merchant/{merchantId}/order/{orderid}/transaction/{transactionid}

Initiate Authentication

Request returning which payer authentication mechanism (e.g. 3-D Secure authentication version 2, 3-D Secure authentication version 1, RuPay PaySecure) the gateway recommends you to use for this order.

Request Parameters

Required Properties for a simple request.

  • Name
    apiOperation
    Type
    string Required
    Description
    INITIATE_AUTHENTICATION
  • Name
    order
    Type
    object Required
    Description
    Information about the order associated with this transaction.

Response Parameters

Required Properties for a simple request.

  • Name
    merchant
    Type
    string
    Description
    The unique identifier issued to you by your payment provider.
  • Name
    order
    Type
    object
    Description
    Information about the order associated with this transaction.
  • Name
    response
    Type
    object
    Description
  • Name
    result
    Type
    enum
    Description
    A system-generated high-level overall result of the operation.
    Enum Options:
    FAILUREPENDINGSUCCESSUNKNOWN
  • Name
    transaction
    Type
    object
    Description
    Information about this transaction.