API REFERENCE

Staging test wallet

Exercise the complete transfer flow without funding an account or moving real money. These endpoints exist only in staging.

Get the wallet

GET /api/test-wallet

API access tokenStaging only

Request

bash

curl "${BASE_URL}/api/test-wallet" \
  --header "Authorization: Bearer ACCESS_TOKEN"

Response

json

{
  "id": "75eddfd6-d0d9-44fc-a0db-764c7d05e660",
  "currency": "USD",
  "balance": "10000.0000",
  "availableBalance": "10000.0000",
  "targetBalance": "10000.0000"
}

Field	Meaning
`balance`	Current recorded wallet balance.
`availableBalance`	Amount available after active transfer holds. Use this for preflight display.
`targetBalance`	Managed staging balance and maximum amount for one test transfer.

The default target is 10000.0000 USD. Read the response instead of hard-coding it because CAPSEND can configure a different staging currency or target.

Automatic refill

Before accepting an eligible staging transfer, CAPSEND restores available test funds to the target when they are below it. The refill is recorded in wallet history as a successful PREFUND with isAutomaticRefill: true.

You do not need to request, schedule, or manage test funding.

Get wallet history

GET /api/test-wallet/transactions

API access tokenStaging only

Request

bash

curl "${BASE_URL}/api/test-wallet/transactions?limit=20&offset=0" \
  --header "Authorization: Bearer ACCESS_TOKEN"

Optional filters:

Parameter	Description
`limit`	1 to 100 records; default `20`.
`offset`	Records to skip; default `0`.
`from`	Inclusive `YYYY-MM-DD` or ISO 8601 creation time.
`to`	Upper date or ISO 8601 creation time. A date includes that full UTC day.
`search`	CAPSEND reference or your external reference.
`status`	`PENDING`, `PROCESSING`, `SUCCESS`, `FAILED`, `PROCESSED`, or `REFUNDED`.
`transactionType`	`PAYOUT`, `PREFUND`, or `REVERSAL`.

Response

json

{
  "data": [
    {
      "id": "218f947d-77d3-465d-ae42-a8aa078ebf28",
      "reference": "CAP-TEST-REFILL-7F9D0B8E",
      "status": "SUCCESS",
      "transactionType": "PREFUND",
      "amount": "100.0000",
      "currency": "USD",
      "isAutomaticRefill": true,
      "createdAt": "2026-10-25T09:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "page": 1,
    "totalPages": 1
  }
}

History responses also include nullable fee, reference, narration, bank, beneficiary summary, failure, and lifecycle timestamp fields. Beneficiary account data is limited to the final four digits.