Wallets

Merchant balances, ledger entries, and holds.

Updated Jul 15, 2026API 2026-07-01 Edit on GitHub Report an issue

Overview

Every account has one wallet per currency. Balances split across available, pending, reserved, and processing.

Method	Path	Description
GET	/v1/wallets	List wallets on your account.
GET	/v1/wallets/{id}	Retrieve a single wallet with balance breakdown.
GET	/v1/wallets/{id}/transactions	Cursor-paginated ledger stream.
POST	/v1/wallets/{id}/holds	Place a temporary hold (e.g. for a marketplace escrow).

GET/v1/wallets

List wallets on your account.

GET/v1/wallets/{id}

Retrieve a single wallet with balance breakdown.

{
  "id": "wal_htg",
  "currency": "HTG",
  "balance": { "available": 1287500, "pending": 45000, "reserved": 0, "processing": 12000 }
}

GET/v1/wallets/{id}/transactions

Cursor-paginated ledger stream.

POST/v1/wallets/{id}/holds

Place a temporary hold (e.g. for a marketplace escrow).