POST {{baseurl}}/bank-accounts
- Staging
- Production
https://gw.stg.girostack.com/v1
https://gw.prod.girostack.com/v1
Headers
string
required
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"
}'
const fetch = require("node-fetch");
const url = "{{API_BASE_URL}}/bank-accounts";
const headers = {
"x-giro-key": "{{SECRET_KEY}}",
"Content-Type": "application/json",
};
const body = JSON.stringify({
accountNumber: "0018730826",
accountName: "Salako Emmanuel",
bankName: "Guaranty Trust Bank",
bankCode: "058",
});
fetch(url, {
method: "POST",
headers: headers,
body: body,
})
.then((response) => response.json())
.then((data) => console.log(data))
.catch((error) => console.error("Error:", error));
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '{{API_BASE_URL}}/bank-accounts',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array(
'x-giro-key: {{SECRET_KEY}}',
'Content-Type: application/json'
),
CURLOPT_POSTFIELDS => json_encode(array(
'accountNumber':'0018730826',
'accountName': 'Salako Emmanuel',
'bankName': 'Guaranty Trust Bank',
'bankCode': '058'
))
));
$response = curl_exec($curl);
$httpcode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if (curl_errno($curl)) {
echo 'Error: ' . curl_error($curl);
} else {
echo "Response Code: $httpcode\n";
echo $response;
}
curl_close($curl);
?>
{
"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": {}
}
}
{
"meta": {
"statusCode": 400,
"error": {
"statusCode": 400,
"message": "Bad request / Validation error",
"messages": {
"bankCode": {
"isNotEmpty": "bankCode should not be empty",
"isString": "bankCode must be a string"
}
}
}
}
}