Transfers

Resolve account name

Changed on

Returns the account holder name registered against a bank account. Show it to whoever authorises the payout: bank transfers settle on account number alone, so this is the only practical protection against paying the wrong person.

get/v1/transfer/name-enquiry

Request

Query parameters

bankCodestring required

Bank code from the bank list.

accountNumberstring required

Account number to resolve.

currencystring

Payout currency.

Response

Success.

statusboolean required

true on success.

messagestring required
codenumber required

Mirrors the HTTP status code.

Example response

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {}
}

Changes

    • breaking

      removed the enum value GHS from the query request parameter currency

    • breaking

      removed the enum value KES from the query request parameter currency

    • breaking

      removed the enum value NGN from the query request parameter currency

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the query request parameter currency became optional

    • info

      added subschema #2 to the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status