Skip to main content
POST
Make an interbank transfer

Authorizations

X-Api-Key
string
header
required

An API key: lsk_<test|live>_<public_id>.. The key also has to be used from an address on its allowlist.

Headers

Idempotency-Key
string
required

A unique value per create (a UUID works). Retrying with the same key and body returns the first result with Idempotent-Replayed: true; the same key with a different body is 409 (code 53).

Body

application/json
account_number
string | null
required
amount_minor
integer<int64>
required
Example:

2500000

beneficiary_bank_code
string | null
required
beneficiary_account_number
string | null
required
beneficiary_account_name
string | null
required
narration
string | null

Response

Accepted

success
boolean
required
message
string | null
required
request_id
string | null
required
Example:

"01a1775167aa7693a7acd8df7b596118"

data
object
code
string | null

Failures only: the numeric code a client branches on (see ErrorCodeNumbers).

Example:

"13"