PaymentsCard processingOne-time payment

Overview

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 strong customer authentication.

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