API Reference · Payouts

Account enquiry

Verify a beneficiary account number and bank code before initiating a payout.

POSThttps://payment.klustar.io/payment/merchant-api/account/inquiry

Headers

X-Tenant-ID

stringrequired

Your tenant identifier (provided during onboarding).

X-API-KEY

stringrequired

Public API key from the merchant dashboard.

X-Merchant-ID

stringrequired

Your business profile / merchant ID (same as appId).

X-Nonce

stringrequired

Unique per-request value (UUID recommended). Never reuse.

X-Timestamp

stringrequired

Unix epoch seconds when the request is signed. Must be within ±300s of server time.

X-Signature

stringrequired

Lowercase hex HMAC-SHA256 of the signature base string, using your secret key.

Content-Type

stringrequired

Must be application/json for JSON bodies.

Defaults to application/json

bankCode

stringrequired

Bank code from the List banks endpoint (e.g. KBC-0618).

accountNumber

stringrequired

10-digit Nigerian NUBAN account number.

application/json

{
  "bankCode": "KBC-0618",
  "accountNumber": "0123456789"
}

Response body

{
  "success": true,
  "code": "00000000",
  "accountName": "JANE DOE",
  "message": "Success"
}

{
  "success": true,
  "code": "00000000",
  "accountName": "JANE DOE",
  "message": "Success"
}