Add Linked Account

Developing

POST

https://api.tranzakt.finance/api/v1/linked-accounts

Links a settlement bank account to your merchant profile. The account is created as Pending and must be approved before it can receive settlements.
Note: bankId is the numeric ID from the supported banks list, not the NIBSS bank code. An account number can only be linked once, and the first account you link becomes primary automatically.

Request

Header Params

Body Params application/jsonRequired

Example

{
  "linkedAccount": {
    "bankId": 57,
    "accountNumber": "0123456789",
    "isPrimary": true
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.tranzakt.finance/api/v1/linked-accounts' \
--header 'x-api-key: Your secret key' \
--header 'Content-Type: application/json' \
--data '{
  "linkedAccount": {
    "bankId": 57,
    "accountNumber": "0123456789",
    "isPrimary": true
  }
}'

Responses

🟢201Success

application/json

Bodyapplication/json

Example

{
    "status": "success",
    "message": "Linked Successfully"
}

🟠400Bad Request

Modified at 2026-09-21 14:15:10

Invalidate Invoice

Webhooks 🔔