5.1.1 API Only
Experience and integration process
| Capabilities | APIs | Description |
|---|---|---|
| Initiate a payment | PAY | Support 3D Secure 2 authentication |
| Submit 3ds result | 3dsIdentify | Submit 3DS info for final payment result |
| Refund a payment | REFUND | |
| Inquiry transaction result | DETAIL | |
| Notify transaction result | NOTIFICATION |
Initiate a payment
When making a card payment, collect the following card details:
| Field | Description | Required |
|---|---|---|
| product | Must be "CARD_PAYMENT" | M |
| expireAt | Default expiration time is 30 minutes | O |
| card.cardNo | The card number. | M |
| card.expYear | YY, The card expiry year. | M |
| card.expMonth | MM, The card expiry month. | M |
| card.cvv | The card verification code. | M |
| card.firstName | The first name of the card holder. | M |
| card.lastName | The last name of the card holder. | M |
| authentication | It is required in 3D Secure 2 authentication flow. Refer to 3D Secure 2 authentication section for more detail | C |
| riskData.source | It's required when payment method is "UNIONPAY" | C |
Handle the payment result
Use the data.status from the PAY response to present the payment result to your shopper. You will also receive the outcome of the payment asynchronously in a NOTIFICATION.
Other case(3D Secure 2 authentication)
The data.status from the PAY response will be in "processing" and there is a payaction data, you can find the description in the section "Payment Flow with 3D Secure 2 authentication".
Updated 5 months ago