Skip to content

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.

Credit card payment flow, successful scenario
  1. Send the first request to /order/v1/client-token-3ds/card-token with the data required for token generation (see the API Reference for the request details).
  2. With the token generated from the card and user data, send the second request to /order/v3/transparent to finalize the order, filling the specialPaymentDetails.card3DSToken field with the token generated in step 1.
  3. The payment is either PAID or CANCELED synchronously, and the response is returned to the client.
Credit card payment flow with 3DS challenge
  1. Send the first request to /order/v1/client-token-3ds/card-token with the data required for token generation.
  2. With the token generated, send the second request to /order/v3/transparent, filling the specialPaymentDetails.card3DSToken field with the token from step 1.
  3. If the payment status returned in step 2 is ANALYSIS, a challenge URL (challengeUrl field) is included in the response payload. Redirect the user to this URL so they can complete the challenge with their bank.
  4. After the user completes the challenge, the payment result is confirmed via webhook notification.