Bank Account
Add Bank Account
Get Started
API Reference
- Account
- Virtual Account
- Disbursement
- Overview
- Bank Account
- Banks
- Transfer
- Transaction
Additional References
Bank Account
Add Bank Account
This endpoint adds a bank account to the list of bank accounts associated with the user. Once added, the bank account can be used for future transfers.
curl --location --request POST '{{API_BASE_URL}}/bank-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"accountNumber": "0018730826",
"accountName": "Salako Emmanuel",
"bankName": "Guaranty Trust Bank",
"bankCode": "058"
}'
{
"meta": {
"statusCode": 201,
"success": true,
"message": "BankAccount successfully created"
},
"data": {
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "Salako Emmanuel",
"accountNumber": "0018730826",
"bankName": "Guaranty Trust Bank",
"bankCode": "058",
"reference": "9999992409440854616574301713288",
"live": true,
"processor": "source",
"publicId": "bka-a709ebef-da69-4570-b1ac-48031u4hd408c",
"id": 3,
"createdAt": "2024-09-13T07:56:16.775Z",
"updatedAt": "2024-09-13T07:56:16.775Z",
"currency": "NGN",
"lastUpdated": "2024-09-13T07:56:16.775Z",
"version": 1,
"beneficiaryType": "personal",
"clientIds": {}
}
}
POST {{baseurl}}/bank-accounts
https://gw.stg.girostack.com/v1
https://gw.stg.girostack.com/v1
https://gw.prod.girostack.com/v1
Headers
Pass your account’s secret key as the value.
curl --location --request POST '{{API_BASE_URL}}/bank-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"accountNumber": "0018730826",
"accountName": "Salako Emmanuel",
"bankName": "Guaranty Trust Bank",
"bankCode": "058"
}'
{
"meta": {
"statusCode": 201,
"success": true,
"message": "BankAccount successfully created"
},
"data": {
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "Salako Emmanuel",
"accountNumber": "0018730826",
"bankName": "Guaranty Trust Bank",
"bankCode": "058",
"reference": "9999992409440854616574301713288",
"live": true,
"processor": "source",
"publicId": "bka-a709ebef-da69-4570-b1ac-48031u4hd408c",
"id": 3,
"createdAt": "2024-09-13T07:56:16.775Z",
"updatedAt": "2024-09-13T07:56:16.775Z",
"currency": "NGN",
"lastUpdated": "2024-09-13T07:56:16.775Z",
"version": 1,
"beneficiaryType": "personal",
"clientIds": {}
}
}
Was this page helpful?
curl --location --request POST '{{API_BASE_URL}}/bank-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"accountNumber": "0018730826",
"accountName": "Salako Emmanuel",
"bankName": "Guaranty Trust Bank",
"bankCode": "058"
}'
{
"meta": {
"statusCode": 201,
"success": true,
"message": "BankAccount successfully created"
},
"data": {
"auth": "65b12bbf512f9932b67f53d7",
"account": "65b12bbf36e38c6bfbe35f95",
"accountName": "Salako Emmanuel",
"accountNumber": "0018730826",
"bankName": "Guaranty Trust Bank",
"bankCode": "058",
"reference": "9999992409440854616574301713288",
"live": true,
"processor": "source",
"publicId": "bka-a709ebef-da69-4570-b1ac-48031u4hd408c",
"id": 3,
"createdAt": "2024-09-13T07:56:16.775Z",
"updatedAt": "2024-09-13T07:56:16.775Z",
"currency": "NGN",
"lastUpdated": "2024-09-13T07:56:16.775Z",
"version": 1,
"beneficiaryType": "personal",
"clientIds": {}
}
}