The Deposit Preauthorization object
Description
The Deposit Preauthorization object enables you to reserve funds on a card so they can be captured later, using two API calls:
- Authorization of the transaction, handled by the Deposit Preauthorization object
- Capture of the funds, handled by the Deposit Preauthorized PayIn object
The Deposit Preauthorization object is used for two payment methods, indicated by the PaymentType:
CARD– Created using POST Create a Card Deposit PreauthorizationPAYPAL– Created using POST Create a PayPal Deposit Preauthorization
In both cases, the capture is made with the same endpoint, POST Create a Deposit Preauthorized PayIn:
CARD– Within 29.5 days.PAYPAL– Within 3 days as recommended by PayPal, but the technical limit is 29 days (not 29.5).
Note that preauthorizations may not be permitted by some issuers and for some card types.
Note – Multi-capture not possible with the Deposit Preauthorization
Multiple partial captures are not possible with the Deposit Preauthorization, for either CARD or PAYPAL. In both cases however, the single capture can be for an amount less than the preauthorized amount.
Note – Disclaimer about terminology
The use of the term “deposit” in this feature is for convenience only and does not constitute a traditional banking deposit under applicable banking regulations, including the EU Capital Requirements Directive (Directive 2013/36/EU) or the Deposit Guarantee Schemes Directive (Directive 2014/49/EU). Accordingly, these funds are not covered by any statutory deposit protection schemes, and Mangopay does not operate as a licensed banking institution.