Create Transfer Recipient

POST

https://devapi.collect.africa/transfers/recipients

Last modified:2025-04-19 09:05:16

Create a transfer recipient

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "RAW_BODY": {
        "name": "string",
        "account_number": "string",
        "bank_code": "string",
        "metadata": {},
        "type": "ng_nuban"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://devapi.collect.africa/transfers/recipients' \
--header 'Content-Type: application/json' \
--data-raw '{
    "RAW_BODY": {
        "name": "string",
        "account_number": "string",
        "bank_code": "string",
        "metadata": {},
        "type": "ng_nuban"
    }
}'

Responses

🟢200OK

application/json

200

Body

Example

{
  "message": "Transfer recipient created successfully",
  "data": {
    "id": 1,
    "name": "Wale Kas",
    "account_name": "MARTINS ADEWALE",
    "account_number": "0227717171",
    "short_code": "TRP_rt8sm0j1je",
    "bank_name": "Guaranty Trust Bank",
    "bank_code": "058",
    "currency": "NGN",
    "country": "NG",
    "created_at": "2021-05-22T14:01:07.638Z",
    "updated_at": "2021-05-22T14:01:07.638Z"
  }
}

🟠400Bad Request

Modified at 2025-04-19 09:05:16

Overview

Get Transfer Recipients