Wallets

Discover your wallet IDs and check their current balances. All endpoints require the standard x-api-key + x-timestamp headers — see Authentication. The client is identified by your API key — there is no client_id parameter, and you can only see your own wallets. Typical flow: list wallets → get balance → create a disbursement.

1. List wallets

GET /api/v3/wallets Returns all of your wallets. Use the returned wallet_id as client_wallet_id when creating a disbursement, and as the wallet_id path parameter in Get wallet balance and List available banks.

curl https://live.launcx.com/api/v3/wallets \
  -H "x-api-key: {{your-v3-api-key}}" \
  -H "x-timestamp: {{unix_timestamp_in_milliseconds}}"

Response

{
  "wallets": [
    {
      "wallet_id": "3f1d6c2a-1b2c-4d5e-8f90-aabbccddeeff",
      "name": "LX-100"
    },
    {
      "wallet_id": "9a8b7c6d-5e4f-4a3b-9c2d-112233445566",
      "name": "LX-101"
    }
  ],
  "total_count": 2
}

Field	Type	Notes
`wallets[].wallet_id`	string (UUID)	Use in disbursement and balance endpoints.
`wallets[].name`	string
`total_count`	integer	Equals the number of items in `wallets`.

If your account has no wallets yet, the response is 200 OK with "wallets": [] and "total_count": 0 — not an error.

2. Get wallet balance

GET /api/v3/wallets/{wallet_id}/balance Returns the current balance of one wallet. The wallet must belong to your client; otherwise 404.

curl https://live.launcx.com/api/v3/wallets/{{wallet_id}}/balance \
  -H "x-api-key: {{your-v3-api-key}}" \
  -H "x-timestamp: {{unix_timestamp_in_milliseconds}}"

Response

{
  "wallet_id": "3f1d6c2a-1b2c-4d5e-8f90-aabbccddeeff",
  "name": "LX-100",
  "balance": "150000.0000"
}

Field	Type	Notes
`wallet_id`	string (UUID)
`name`	string
`balance`	string (decimal)	4 fraction digits, in `IDR`. Can be negative.

balance is a decimal string — parse it with a decimal type, never as a float. Floating-point rounding on money values will cause reconciliation mismatches.

3. Errors

Status	When
`400`	Invalid `wallet_id` (not a UUID), or missing/invalid/stale `x-timestamp` (must be within ±5 minutes of server time).
`401`	Missing or invalid `x-api-key`.
`404`	`wallet not found` — the wallet does not exist, does not belong to your client, or is not fully provisioned yet (balance endpoint only).
`500`	Internal error — retry, then contact support.

If you get a 404 for a wallet ID you believe is yours, re-check it against List wallets.

Getting Started

Payments

Disbursements

Migration

Wallets

1. List wallets

Response

2. Get wallet balance

Response

3. Errors

​1. List wallets

​Response

​2. Get wallet balance

​Response

​3. Errors

1. List wallets

Response

2. Get wallet balance

Response

3. Errors