Service Description
4 APIs are available in order for you to initiate single and/or bulk payment instruction(s):
-
SEPA Standard payment request API (unitary or bulk): initiate payments in EUR within the SEPA zone.
-
International payment request API (unitary or bulk) : initiate cross border payments.
-
Treasury payment request API (unitary or bulk) Not to be used yet; available soon: initiate payments between entities of the same Group. -
-
Payment status API : retrieve the status of your previously initiated payment(s).
Format
-
The payload must be formatted in ISO 20022 version 3 (pain.001.001.03) format, either in XML (XML tag) or in JSON (message item).
-
Please adapt the Content-Type header (application/xml or application/json) according to the format of your payment file.
Data content
A payment request might embed several payment instructions having:
-
one single requested execution date.
-
one single beneficiary or multiple beneficiaries.
Prerequisites for all use cases
-
You provided a valid SSL/TLS certificate to BNP Paribas.
-
You provided a valid Electronic Signature certificate (Eidas, RGS*, RGS** or 3SKEY) to BNP Paribas.
-
You were provided with your credentials (ClientID, ClientSecret and KeyID), by BNP Paribas, allowing you to request an access token (type "Client Credentials").
Payment Process
In case your file is correctly formated, your payment initiation request will generate a unique BNPP reference {PaymentId} which will allow you to consult the status of your credit transfer, as well as the status of your instructions and transactions (PSR).