Availability:
  • All card types

​
Process

Processing a one-time card payment is a multi-step process:
1

Card tokenization

Register the card to tokenize its sensitive data so it can be used for payment.
2

Payment request

Call the POST Create a Direct Card PayIn endpoint to initiate the payment.
3

3DS redirection

If required by the issuer, redirect the user to the issuer’s Access Control Server (ACS) to complete .
4

Payment outcome

Mangopay updates the Statusof the pay-in from CREATED to SUCCEEDED or FAILED to indicate the result.Set up webhooks for the following event types:
  • PAYIN_NORMAL_SUCCEEDED
  • PAYIN_NORMAL_FAILED
Call the GET View a PayIn endpoint to confirm the result and customize the user’s post-pay experience.
5

Card deactivation

Call the PUT Deactivate or edit a Card endpoint to disable the CardId if you don’t have the user’s permission to save their payment details.
See the how-to guide for a detailed walkthrough of these steps you need to take:

How to

Process a one-time card payment

​
Sequence diagram

The following diagram details the full flow described above:

Test cards

Use Mangopay’s dedicated test cards in Sandbox

Endpoints

The Direct Card PayIn object

Guides

Learn more about 3DS and SCA