Bank wire
| Region | International |
|---|---|
| Currencies | See the currencies page for details |
| Refunds | Supported via payouts |
| Disputes | Not supported |
About
Bank wire pay-ins – also known as wire, credit, or bank transfers – enable users to wire funds to a Mangopay wallet by requesting the payment with their bank (for example, from their bank’s online banking app).
Unlike pay-ins to virtual IBANs, Mangopay’s bank wire pay-in relies on a specific wire reference for the payment, which must be entered by the user when they initiate the wire transfer with their bank.
How it works
The platform creates a bank wire pay-in
The platform calls the POST Create a Direct Bank Wire PayIn endpoint to initiate the payment flow.
This call enables the platform to obtain the bank account details and wire reference that the user must use. The platform must also declare the amount and currency of the payment.
Mangopay returns the bank details
In the response from the API, Mangopay returns the BankAccount parameter object containing the IBAN and BIC to which the user must send the funds.
The WireReference parameter contains the reference that must also be passed by the user to their bank.
The platform displays the bank details to the user
The platform must display the details as they appear in the response of the pay-in call.
Best practice – Display instructions and details clearly to the user
Your user must understand that they need to initiate the bank wire on their side using the wire reference.
Ensure your messaging is clear and that the BankAccount and WireReference values are easy to copy and use.
Caution – Do not hardcode bank details
Mangopay may periodically change the underlying bank account details without prior notice in an effort to offer the best quality of service.
Ensure you retrieve the BankAccount object parameter dynamically so the IBAN, BIC, and other response values appear as returned in for each pay-in.
Note – Mismatched data may lead to delays
If any of the reference, bank details, amount, or currency are not those specified in the pay-in, delays or failures can occur.
The user makes the payment via online banking
The user requests the wire transfer via their online banking app, specifying:
- The payee as the account information provided in the
BankAccountparameter object - The payment reference as the
WireReferencevalue - The amount matching the
DeclaredDebitedFunds
Note – Funds must be received within 1 month
Mangopay must receive the payment within 1 month of the pay-in’s CreationDate. Past this period, the Status changes to FAILED and the WireReference can no longer be used to reconcile the payment. A new pay-in must be created.
Mangopay reconciles the payment and credits the wallet
When Mangopay receives the funds on the account, it uses the WireReference to identify the payment and credit the funds to the wallet. This process is known as reconciliation.
When the payment is successfully received and reconciled by Mangopay, the pay-in object Status changes to SUCCEEDED.
Mangopay also updates the TransactionDetails response object with data received from banking partners, based on Camt messages as per ISO 20022. If data is not available, or if the pay-in is not yet succeeded, then data is not returned.
Payment outcome
When the payment is successfully received and reconciled by Mangopay, the pay-in object Status changes to SUCCEEDED.
You should also set up webhook notifications for the relevant event types:
- PAYIN_NORMAL_SUCCEEDED
- PAYIN_NORMAL_FAILED
Use the GET View a PayIn endpoint on the resource ID to confirm the payment details before notifying the user of the outcome.
Testing
You can use the Dashboard’s Sandbox Operations features to simulate the user making the wire transfer in their online banking app.