Skip to main content

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

ParameterTypeMandatoryDescription
merchantIdStringMMerchant identifier
orderIdNumberMOrder identifier
stanStringMSystem 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

ParameterTypeMandatoryDescription
responseCodeStringMPayment Gateway response code
messageStringMPayment Gateway response message
orderObjectM 
order.idNumberMOrder identifier
order.merchantIdNumberMMerchant identifier which own this order
order.merchantReferenceStringMYour reference for the order
order.currencyStringM3-Letters ISO currency code of the order
order.amountNumberMOrder amount
order.netAmountNumberMNet amount of the order
order.cardTypeStringMCard type of the order
order.createTimeDatetimeMTimestamp when the order is created. Maintained by the Payment Gateway
order.updateTimeDatetimeMTimestamp when the order is last updated. Maintained by the Payment Gateway
order.statusStringMStatus of the order. Maintained by the Payment Gateway
order.recurringBooleanMFlags the order is a recurring order or not
transactionObjectM 
transaction.idNumberMTransaction identifier for the recurring transaction
transaction.merchantIdNumberMMerchant identifier which own this transaction
transaction.typeStringMTransaction type
transaction.amountNumberMTransaction amount
transaction.statusStringMStatus of the transaction. Maintained by the Payment Gateway
transaction.maskedPanStringMMasked card number of the transaction if supported by the payment method
transaction.stanStringMSystem 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"
}
}