Credit card payments
To complete a payment using a credit card, follow the flow below. There are two possible scenarios, depending on whether the issuer requires a 3DS challenge.
Payment without challenge
Section titled “Payment without challenge”
- Send the first request to
/order/v1/client-token-3ds/card-tokenwith the data required for token generation (see the API Reference for the request details). - With the token generated from the card and user data, send the second
request to
/order/v3/transparentto finalize the order, filling thespecialPaymentDetails.card3DSTokenfield with the token generated in step 1. - The payment is either PAID or CANCELED synchronously, and the response is returned to the client.
Payment with 3DS challenge
Section titled “Payment with 3DS challenge”
- Send the first request to
/order/v1/client-token-3ds/card-tokenwith the data required for token generation. - With the token generated, send the second request to
/order/v3/transparent, filling thespecialPaymentDetails.card3DSTokenfield with the token from step 1. - If the payment status returned in step 2 is ANALYSIS, a challenge URL
(
challengeUrlfield) is included in the response payload. Redirect the user to this URL so they can complete the challenge with their bank. - After the user completes the challenge, the payment result is confirmed via webhook notification.