Create Transfer

POST

https://devapi.collect.africa/transfers

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

Make a bank transfer with an already created 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": {
        "amount": 0,
        "recipient": "string",
        "reference": "string",
        "narration": "string",
        "metadata": {},
        "pin": "\"1234\""
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://devapi.collect.africa/transfers' \
--header 'Content-Type: application/json' \
--data-raw '{
    "RAW_BODY": {
        "amount": 0,
        "recipient": "string",
        "reference": "string",
        "narration": "string",
        "metadata": {},
        "pin": "\"1234\""
    }
}'

Responses

🟢200OK

application/json

200

Body

Example

{
  "message": "Transfer created successfully",
  "data": {
    "id": 1,
    "amount": 10000,
    "fee": 5000,
    "currency": "NGN",
    "status": "pending",
    "short_code": "TRF_qm11kfckpf",
    "reference": "1112222",
    "narration": "string",
    "source": "balance",
    "metadata": {},
    "recipient": {
      "id": 1,
      "name": "Wale Test",
      "account_name": "MARTINS ADEWALE",
      "account_number": "0227172785",
      "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"
    },
    "transferred_at": null,
    "created_at": "2021-05-24T11:36:42.000Z",
    "updated_at": "2021-05-24T11:36:42.000Z"
  }
}

🟠400Bad Request

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

Get Transfer Recipient

Get Transfers