Complete Authentication
- Description: Confirm 3DS authentication is finished, last step of completing a payment
- Path:
/direct/complete-authentication
- Method:
POST
- Request Header:
Content-Type: application/json
Request Parameters
Parameter | Type | Mandatory | Description |
---|---|---|---|
merchantId | String | M | Merchant identifier |
orderId | Number | M | Order identifier |
stan | String | M | System trace audit number for the transaction |
Example:
{
"request": "{\"merchantId\":3,\"orderId\":4250,\"stan\":\"D1704\"}",
"signature": "CRUlepcZ8nxwTTZOJnJMDPhW+cXrtfbhH8ACieXyWyE5mLDQevc+rXD2lmRtk3Qf9Lj22Puh6LdzzcXlfNNZDuTz0EKoBmeZX7PVJDZLz4eJFeFgWnjMQ2g/mLKniKrUA1Q9L4K0znwDPx4nAH65zoUAON8XFqv9UKhEwY0cVbYddPfMaTl9+RMOda6FqVhVVJnDScFNFbBp+fzdcSDwlOpl7OcqouOHPOSg4AceIWLPfEY5R/wrJVmYFz/+9DGRMNkJrL1TQGhyFLY1Aehdxu3EGKWS/Va9w9GEZywY8jb6ryXif9e/lAUPH2Nv/OQ2T9HwN13yerWZJ0NWBEZzmg=="
}
Response Parameters
Parameter | Type | Mandatory | Description |
---|---|---|---|
responseCode | String | M | Payment Gateway response code |
message | String | M | Payment Gateway response message |
order | Object | M | |
order.id | Number | M | Order identifier |
order.merchantId | Number | M | Merchant identifier which own this order |
order.merchantReference | String | M | Your reference for the order |
order.currency | String | M | 3-Letters ISO currency code of the order |
order.amount | Number | M | Order amount |
order.netAmount | Number | M | Net amount of the order |
order.cardType | String | M | Card type of the order |
order.createTime | Datetime | M | Timestamp when the order is created. Maintained by the Payment Gateway |
order.updateTime | Datetime | M | Timestamp when the order is last updated. Maintained by the Payment Gateway |
order.status | String | M | Status of the order. Maintained by the Payment Gateway |
order.recurring | Boolean | M | Flags the order is a recurring order or not |
transaction | Object | M | |
transaction.id | Number | M | Transaction identifier for the recurring transaction |
transaction.merchantId | Number | M | Merchant identifier which own this transaction |
transaction.type | String | M | Transaction type |
transaction.amount | Number | M | Transaction amount |
transaction.status | String | M | Status of the transaction. Maintained by the Payment Gateway |
transaction.maskedPan | String | M | Masked card number of the transaction if supported by the payment method |
transaction.stan | String | M | System trace audit number for the transaction |
Example:
{
"responseCode": "0000",
"message": "Success",
"order": {
"id": 4250,
"merchantId": 3,
"merchantReference": "M20220627102712",
"currency": "HKD",
"amount": 100.00,
"netAmount": 100.00,
"cardType": "VISA",
"email": "",
"createTime": "2022-06-27T08:27:13.000+00:00",
"updateTime": "2022-07-14T03:05:39.107+00:00",
"status": "SUCCESS",
"recurring": false
},
"transaction": {
"id": 1704,
"merchantId": 3,
"type": "SALE",
"amount": 50.00,
"currency": "HKD",
"status": "SUCCESS",
"maskedPan": "400000XXXXXX0002",
"stan": "D1704"
}
}