RegionInternational
CurrenciesSee the currencies page for details
RefundsSupported via payouts
DisputesNot 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

1

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.
2

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.
3

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 userYour 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 detailsMangopay 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 delaysIf any of the reference, bank details, amount, or currency are not those specified in the pay-in, delays or failures can occur.
4

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 BankAccount parameter object
  • The payment reference as the WireReference value
  • The amount matching the DeclaredDebitedFunds
Note – Funds must be received within 1 monthMangopay 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.
5

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.

Guides

All currencies supported by Mangopay

Endpoints

POST Create a Bank Wire PayIn

Endpoints

POST Create a Direct Bank Wire PayIn to the Repudiation Wallet