UserCategory
of OWNER
(see categories)KYCLevel
of REGULAR
for payment services platforms).PayoutMethod
of LocalBankTransfer
.
PayoutMethod
of InternationalBankTransfer
.
Status
changes from CREATED
to SUCCEEDED
) but there can be a delay in some circumstances.
In the SEPA zone, platforms can take advantage of a choice of schemes (SCT, SCT Inst, and T2), and so you need to use the PayoutModeRequested
parameter to specify the scheme for each payout request. Mangopay also offers a fallback mechanism for SCT Inst to be processed as SCT if the instant request fails. See initiate an SCT Inst payout for details.
PayoutModeRequested
to RTGS_PAYMENT
in calls to the POST Create a Payout endpoint.
Funds are usually processed the same working day. The T2 scheme is open 07:00 – 16:15 CET, 5 days a week. Payout requests received outside these hours are processed the next working day. The T2 scheme is closed at weekends and on the following days if they fall on a weekday: 1 January (New Year’s Day), Good Friday, Easter Monday, 1 May (Labour Day), 25 December (Christmas Day), 26 December.
Amount
value 1
), and the Faster Payments System (FPS) in the UK allows GBP 0.01 (Amount
value 1
). Other schemes may impose different minimum amounts.
Currency
of the payout and the Country
of the Recipient.
The Payout request’s BankAccountId
field can contain the Id
of a Recipient or a legacy Bank Account.
BankAccountId
as the RecipientId
path parameter. For example, if the legacy Bank Account was bankacc_m_01JCN1X2EHWG0JNJNPNQ21CW5G
, call the endpoint with that ID:
GET /v2.01/{ClientId}/recipients/bankacc_m_01JCN1X2EHWG0JNJNPNQ21CW5G
The API responds with a Recipient object containing the information of the legacy Bank Account:
Currency
for each Recipient to improve payout deliverability, meaning that the same real-life account can be registered multiple times (with different PayoutMethod
values).
The table below shows the values assigned to legacy Bank Accounts when Mangopay migrated them to Recipients. In addition to the data below, the RecipientScope
assigned was PAYOUT
for all accounts (which can be used for PAYIN
use cases).
Bank Account Type | Recipient PayoutMethod | Recipient Currency | Recipient Country |
---|---|---|---|
IBAN | LocalBankTransfer if IBAN indicates a SEPA country, InternationalBankTransfer if not | Based on the IBAN country (EUR if SEPA country or local non-EUR) | Based on the IBAN |
GB | LocalBankTransfer | GBP | GB |
US | LocalBankTransfer | USD | US |
CA | LocalBankTransfer | CAD | CA |
OTHER | InternationalBankTransfer | Based on the BIC | Based on the BIC |
IBAN
(not the BIC
)PayoutMethodType
= LocalBankTransfer
Currency
= EUR
PayoutMethodType
= InternationalBankTransfer
Currency
= Local currency based on predefined list (e.g. DKK
, PLN
, etc)