ClientId
and an API key – if you don’t have these, contact Sales to get access to the Mangopay DashboardVALID
or registered less than 24 hours ago, to make the paymentsPOST /v2.01/{ClientId}/preauthorizations/card/direct
Id
of the Preauthorization for the next steps.
SecureModeRedirectURL
value to complete strong customer authentication, unless it is null
. If SecureModeRedirectURL
is null
, this means that 3DS is not required and no redirection is needed.
You can also use the SecureModeNeeded
boolean to determine this redirection behavior.
For more information on how to handle 3DS redirection, see Steps 4, 6, and 7 of the How to process a card payment guide.
PaymentStatus
is WAITING
, you can capture the funds with a preauthorized pay-in.
The preauthorized pay-in must be:
EventType
in order to be notified when it is possible or too late to make a pay-in against a preauthorization:
Id
of the Preauthorization obtained previously as the PreauthorizationId
.
Amount
value of the DebitedFunds
is equal to the preauthorized funds.
POST /v2.01/{ClientId}/payins/preauthorized/direct
PaymentStatus
changes to VALIDATED
as there are no RemainingFunds
left to be captured.
Use the View a Preauthorization endpoint to see this:
POST /v2.01/{ClientId}/payins/preauthorized/direct
RemainingFunds
equals the initial preauthorized funds minus de pay-in DebitedFunds
and Fees
.PaymentStatus
remains as WAITING
, allowing you to make another capture for the remaining funds.CardType
is CB_VISA_MASTERCARD
, you can make as many partial captures as needed until you reach the preauthorized amount.
If you know that you won’t use the remaining preauthorized funds before the end of the hold period, you can release the funds manually to free them for the user (see Step 3).
Once the hold period is over:
PaymentStatus
changes to VALIDATED
.PaymentStatus
changes to EXPIRED
.ExpirationDate
to release the preauthorized funds for the user. If you don’t do this, the funds will be released at the ExpirationDate
PaymentStatus
to VALIDATED
.
PUT /v2.01/{ClientId}/preauthorizations/{PreauthorizationId}
PaymentStatus
to CANCELED
.
PUT /v2.01/{ClientId}/preauthorizations/{PreauthorizationId}