Initiate Payout Request

POST /handler/send/remittance/transaction

This endpoint initiates a payout request by sending a list of transactions to CSL Pay for processing. A partner would call this endpoint when they wish to instruct CSL Pay to make payments to multiple recipients. The request must include a list of transactions, each with the required details such as recipient information and payment amounts.

Types inferred from examples. This endpoint came from a Postman collection, which declares no schema — field types are read from the example values and no field is marked required.

Request body

Field	Type	Description
transactionRequestList	array	—
transactionReference required	string	—
requestDate	string	—
paymentCurrency	string	—
paymentAmount	string	—
paymentNarration	string	—
recipientInformation	object	—
recipientAccountNumber	string	—
recipientAccountName	string	—
recipientBankCode	string	—
recipientPhoneNumber	string	—
recipientISOCountryCode	string	—
senderInformation	object	—
senderName	string	—
senderEmailAddress	string	—
senderPhoneNumber	string	—
senderISOCountryCode	string	—

Response 201

Field	Type	Description
batchId	string	—
totalCount	integer	—
errorTransactionCount	integer	—
createDate	string	—

Environment

Request

curl -X POST "https://api.dev.cslpay.io/handler/send/remittance/transaction" \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  -d '{
  "transactionRequestList": [
    {
      "transactionReference": "790598202501304567654576987851",
      "requestDate": "2025-01-30T11:40:01.833Z",
      "paymentCurrency": "NGN",
      "paymentAmount": "1.00",
      "paymentNarration": "Test Transaction",
      "recipientInformation": {
        "recipientAccountNumber": "0106462100",
        "recipientAccountName": "Ukange Ushahemba",
        "recipientBankCode": "058",
        "recipientPhoneNumber": "",
        "recipientISOCountryCode": "NGA"
      },
      "senderInformation": {
        "senderName": "Terngu Ukange",
        "senderEmailAddress": "",
        "senderPhoneNumber": "",
        "senderISOCountryCode": "USA"
      }
    }
  ]
}'

OkHttpClient client = new OkHttpClient();

String payload = """
    {
      "transactionRequestList": [
        {
          "transactionReference": "790598202501304567654576987851",
          "requestDate": "2025-01-30T11:40:01.833Z",
          "paymentCurrency": "NGN",
          "paymentAmount": "1.00",
          "paymentNarration": "Test Transaction",
          "recipientInformation": {
            "recipientAccountNumber": "0106462100",
            "recipientAccountName": "Ukange Ushahemba",
            "recipientBankCode": "058",
            "recipientPhoneNumber": "",
            "recipientISOCountryCode": "NGA"
          },
          "senderInformation": {
            "senderName": "Terngu Ukange",
            "senderEmailAddress": "",
            "senderPhoneNumber": "",
            "senderISOCountryCode": "USA"
          }
        }
      ]
    }
""";

RequestBody body = RequestBody.create(
        payload, MediaType.get("application/json"));

Request request = new Request.Builder()
        .url("https://api.dev.cslpay.io/handler/send/remittance/transaction")
        .post(body)
        .addHeader("Authorization", "Bearer <access-token>")
        .addHeader("Content-Type", "application/json")
        .build();

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) {
        throw new IOException("Unexpected status " + response.code());
    }
    System.out.println(response.body().string());
}

const response = await fetch("https://api.dev.cslpay.io/handler/send/remittance/transaction", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <access-token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "transactionRequestList": [
      {
        "transactionReference": "790598202501304567654576987851",
        "requestDate": "2025-01-30T11:40:01.833Z",
        "paymentCurrency": "NGN",
        "paymentAmount": "1.00",
        "paymentNarration": "Test Transaction",
        "recipientInformation": {
          "recipientAccountNumber": "0106462100",
          "recipientAccountName": "Ukange Ushahemba",
          "recipientBankCode": "058",
          "recipientPhoneNumber": "",
          "recipientISOCountryCode": "NGA"
        },
        "senderInformation": {
          "senderName": "Terngu Ukange",
          "senderEmailAddress": "",
          "senderPhoneNumber": "",
          "senderISOCountryCode": "USA"
        }
      }
    ]
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.dev.cslpay.io/handler/send/remittance/transaction",
    headers={
        "Authorization": "Bearer <access-token>",
        "Content-Type": "application/json"
    },
    json={
      "transactionRequestList": [
        {
          "transactionReference": "790598202501304567654576987851",
          "requestDate": "2025-01-30T11:40:01.833Z",
          "paymentCurrency": "NGN",
          "paymentAmount": "1.00",
          "paymentNarration": "Test Transaction",
          "recipientInformation": {
            "recipientAccountNumber": "0106462100",
            "recipientAccountName": "Ukange Ushahemba",
            "recipientBankCode": "058",
            "recipientPhoneNumber": "",
            "recipientISOCountryCode": "NGA"
          },
          "senderInformation": {
            "senderName": "Terngu Ukange",
            "senderEmailAddress": "",
            "senderPhoneNumber": "",
            "senderISOCountryCode": "USA"
          }
        }
      ]
    },
)

response.raise_for_status()
print(response.json())

Response

201Send Payout Request

{
  "batchId": "accf8c3c-6bb1-4c0f-b8da-83e24d1fe100",
  "totalCount": 1,
  "errorTransactionCount": 0,
  "createDate": "2026-08-07 19:01:33"
}

Authorization

Authorization: Bearer <access-token>

Sent on every request. See Getting started.