curl --location --request POST '{{API_BASE_URL}}/transit-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "accountName": "John Doe",
    "currency": "NGN",
    "settlementAccount": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61"
}'

{
  "meta": {
    "statusCode": 201,
    "success": true,
    "message": "TransitAccount successfully created"
  },
  "data": {
    "publicId": "vba-6989bcba-15b0-4552-8d78-44fc0b1dd06d",
    "auth": "678b12bbf36cc2c6b76635f95",
    "account": "65b12bbf36e38c6bfbe35f95",
    "settlementAccount": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61",
    "accountName": "John Doe",
    "accountNumber": "9003053347",
    "bankName": "Source MFB",
    "bankCode": "090641",
    "live": true,
    "alias": "John Doe",
    "processor": "source",
    "reference": null,
    "id": 2,
    "createdAt": "2024-08-03T11:44:18.841Z",
    "updatedAt": "2024-08-03T11:44:18.841Z",
    "balance": 0,
    "currency": "NGN",
    "lastUpdated": "2024-08-03T11:44:18.841Z"
  }
}

POST {{baseurl}}/transit-accounts

https://gw.stg.girostack.com/v1

Headers

​
x-giro-key
string
required

Pass your account’s secret key as the value.

Body Params

​
accountName
string
required

Value could be business’ name

​
currency
string
required

Value should be NGN

​
settlementAccount
string
required

Value should be the publicId of the wallet where you want incoming transactions to be settled.

​
emailAddress
string

Value should be a valid email address

​
mobile
object

The mobile number of the customer

 {
        "phoneNumber": "08142351599",
        "isoCode": "NG"
}

curl --location --request POST '{{API_BASE_URL}}/transit-accounts' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "accountName": "John Doe",
    "currency": "NGN",
    "settlementAccount": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61"
}'

{
  "meta": {
    "statusCode": 201,
    "success": true,
    "message": "TransitAccount successfully created"
  },
  "data": {
    "publicId": "vba-6989bcba-15b0-4552-8d78-44fc0b1dd06d",
    "auth": "678b12bbf36cc2c6b76635f95",
    "account": "65b12bbf36e38c6bfbe35f95",
    "settlementAccount": "vba-19aeceea-1bd6-4e85-89fa-2ca0b1c57d61",
    "accountName": "John Doe",
    "accountNumber": "9003053347",
    "bankName": "Source MFB",
    "bankCode": "090641",
    "live": true,
    "alias": "John Doe",
    "processor": "source",
    "reference": null,
    "id": 2,
    "createdAt": "2024-08-03T11:44:18.841Z",
    "updatedAt": "2024-08-03T11:44:18.841Z",
    "balance": 0,
    "currency": "NGN",
    "lastUpdated": "2024-08-03T11:44:18.841Z"
  }
}

Was this page helpful?