FAfatzebra

Authenticate a transaction

Changed on

This API is used to authenticate a transaction. The first step is to call this API with sca.type = "enrollment" to check whether the transaction is frictionless or needs further challenge. After a successful challenge, this API should be called with sca.type = "validation" which will return 3DS2/SCA fields.

post/authenticate

Request

  • Base URL
    https://gateway.pmnts-sandbox.io/v1.0
  • URL
    https://gateway.pmnts-sandbox.io/v1.0/authenticate
  • Auth
    HTTP basic

Headers

Content-Typestring

application/json

Request body

card_tokenstring required
amountinteger required

A positive integer representing how much to charge, in the smallest currency unit (eg., 100 to charge $1.00, or 100 to Charge ¥100, a zero decimal currency)

currencystring required

Three letter ISO currency code, in UPPERCASE

customer_ipstring

RFC791-compliant IP address

Response

200

OR
OR
OR
OR

Example response

{
  "successful": true,
  "response": {
    "action": {
      "proceed": true,
      "frictionless": true
    },
    "version": "2.2.0",
    "enrolled": "Y",
    "pares": "Y",
    "xid": "Y2FyZGluYWxjb21tZXJjZWF1dGg=",
    "eci": "05",
    "cavv": "Y2FyZGluYWxjb21tZXJjZWF1dGg=",
    "authentication_result": "0",
    "authentication_transaction_id": "3gbaF10cRR3AKYlHWR70",
    "authentication_status_message": "Success",
    "card_bin": "400000",
    "card_type_name": "VISA",
    "commerce_indicator": "vbv",
    "request_id": "5765389399326807603008",
    "request_token": "AxjzbwSTOIrZyFh1GLdAAAoBUaf/fn4iEg6cQkhoZNJMvRivpPBAFAAA7gPd",
    "decision": "ACCEPT"
  },
  "test": true
}

Changes