Try it out in Postman: View Postman Collection
Try it out in Postman: View Postman Collection
By submitting a new beneficiary, you must supply the relevant details in order to execute a payment.
Note : each of your physical IBAN accounts hold with iBanFirst will be automatically created when subscribing with us.
The Submit a new beneficiary service allows to reference external accounts which can be either your own accounts in another bank or a third party account.
Adding an external bank has some rules :
This service include verifications on the format of the account created. The API has been made in order to accept local specification of cross-boarder payments.
The API accepts the following formats of external bank accounts :
the account to post
A String representing the Three-digit ISO 4217 Currency Code of a currency. This String only contains capitalized letters.
Representation of a beneficiary bank.
Eight or eleven-digit ISO 9362 Business Identifier Code specifying the Recipient Bank. This field is optional only when the account number does not have an Iban format.
The two-digit code specifying the local clearing network. If you does not have a bic, this field is required.
The code identifying the branch number on the local clearing network. If you does not have a bic, this field is required.
What we call a Holder can be either an Individual or an Organisation that own the account. May also be referred to as: Beneficiary/Supplier/Vendor/Payee/Recipient.
In the beneficiary address, only the Country is mandatory, but you can specify all fields to be more precise.
curl -i -X POST \
https://sandbox.ibanfirst.com/api/externalBankAccounts/ \
-H 'Content-Type: application/json' \
-d '{
"accountNumber": "string",
"currency": "USD",
"holderBank": {
"bic": "string",
"clearingCodeType": "st",
"clearingCode": "string",
"name": "string",
"address": {
"street": "string",
"postCode": "string",
"city": "string",
"province": "st",
"country": "string"
}
},
"holder": {
"name": "string",
"type": "Individual",
"address": {
"street": "string",
"postCode": "string",
"city": "string",
"province": "st",
"country": "string"
}
},
"tag": "string",
"correspondentBic": "string"
}'{ "id": "Na5Dv6E", "currency": null, "tag": "string", "accountNumber": "string", "correspondentBank": { "bic": "string", "name": "string", "address": { … } }, "holderBank": { "bic": "string", "clearingCodeType": "st", "clearingCode": "string", "name": "string", "address": { … } }, "holder": { "name": "string", "type": "Individual", "address": { … } } }
curl -i -X GET \
'https://sandbox.ibanfirst.com/api/externalBankAccounts/?page=1&per_page=50&sort=ASC'OK
A String representing the id of an object. This string contains alpha-numeric characters, including the capital ones.
The code specifying the account (can be either an Iban or an account number).
What we call a Holder can be either an Individual or an Organisation that own the account. May also be referred to as: Beneficiary/Supplier/Vendor/Payee/Recipient.
In the beneficiary address, only the Country is mandatory, but you can specify all fields to be more precise.
[ { "id": "Na5Dv6E", "currency": null, "tag": "string", "accountNumber": "string", "correspondentBank": { … }, "holderBank": { … }, "holder": { … } } ]
curl -i -X GET \
'https://sandbox.ibanfirst.com/api/externalBankAccounts/{id}'{ "id": "Na5Dv6E", "currency": null, "tag": "string", "accountNumber": "string", "correspondentBank": { "bic": "string", "name": "string", "address": { … } }, "holderBank": { "bic": "string", "clearingCodeType": "st", "clearingCode": "string", "name": "string", "address": { … } }, "holder": { "name": "string", "type": "Individual", "address": { … } } }
curl -i -X DELETE \
'https://sandbox.ibanfirst.com/api/externalBankAccounts/{id}'{ "result": true }
Sending funds from one of your iBanFirst accounts to your own bank account or a third-party recipient involves two steps:
Generate the payment object with the 'Submit Payment' method.
A unique id is assigned to each payment.
Use the 'Confirm Payment' method to send the payment for processing. When you confirm a payment, make sure you have sufficient funds in your account balance.
Caution:
Payments are automatically rolled to the next closest working days if not confirmed in the scheduled date of operation. If the balance of your account is not sufficient to cover the payment amount, funds may be locked-in by iBanFirst.
The API provides a deliverable FX facility and deliverable FX liquidity. You will become counterparty to iBanFirst and can market and sell deliverable FX services to corporate and private clients as well as using such services on their behalf.
FX trades are always made between two accounts of a unique counterparty. iBanFirst will automatically debit the source account and credit the delivery account at the date specified in the FX trade instructions. If the delivery date has been scheduled, the delivery is automatically processed in the morning before 00:30 am Paris time. If the delivery date is today (TOD), the funds is available on your account by the next 20mn.
A FX trades also involves an amount, which includes both the numeric amount and the currency in order to define if this amount is the nominal to be bought or sold, for example: '100000.00+GBP'.