Anonymous transfer

TODO — The source documentation for this endpoint was incomplete. The response body was not documented. Verify the following before publishing:

Confirm the complete response fields
Confirm whether a payerAccountNumber is required or optional
Clarify the difference between this endpoint and the standard customer transfer

Endpoint

POST /clients/business/customers/funds/anonymous-transfer

Headers

string

required

Your public API key.

string

required

Your API secret. Use a stl_test_... value in sandbox, stl_live_... in production.

string

required

Your business ID.

Request body

integer

required

Amount to transfer, in kobo.

string

required

The destination bank account number.

string

required

The bank code of the receiving bank.

string

required

A unique reference you generate for this transaction.

string

required

A description of the transfer.

Code examples

curl -X POST https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/anonymous-transfer \
  -H "x-api-key: stl_c8e286ca55b0123e0b05da047494f585" \
  -H "x-api-secret: stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0" \
  -H "businessId: YOUR_BUSINESS_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150000,
    "receiverAccountNumber": "0123456789",
    "receiverBankCode": "011",
    "retrievalReference": "anon_txn_001",
    "narration": "Anonymous payment"
  }'

const res = await fetch(
  "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/anonymous-transfer",
  {
    method: "POST",
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      businessId: "YOUR_BUSINESS_ID",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      amount: 150000,
      receiverAccountNumber: "0123456789",
      receiverBankCode: "011",
      retrievalReference: "anon_txn_001",
      narration: "Anonymous payment",
    }),
  }
);
const json = await res.json();

import requests

res = requests.post(
    "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/anonymous-transfer",
    headers={
        "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
        "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
        "businessId": "YOUR_BUSINESS_ID",
    },
    json={
        "amount": 150000,
        "receiverAccountNumber": "0123456789",
        "receiverBankCode": "011",
        "retrievalReference": "anon_txn_001",
        "narration": "Anonymous payment",
    },
)
print(res.json())

Overview

Members

Business

Virtual accounts

Funds

Bulk transfers

Disputes

Subscriptions

Payouts

Audit logs

Settings

Endpoint

Headers

Request body

Code examples

​Endpoint

​Headers

​Request body

​Code examples

Endpoint

Headers

Request body

Code examples