List payout wallets

GET /api/v1/partner/customers/{customerId}/payout-wallets

Required scope: payout_wallets:read, plus the payout_wallets capability.

Returns the customer’s fiat payout wallet book: the stablecoin wallets its fiat settlements are paid to. Exactly one active wallet has is_payout_wallet: true once the book is set up. Archived wallets are included so you can reconcile history. Reading the book does not require the merchant to be currently eligible to transact.

Request

curl https://www.niftipay.com/api/v1/partner/customers/{customerId}/payout-wallets \
  -H "Authorization: Bearer <partner_api_key>"

Response 200

{
  "request_id": "req-1",
  "api_version": "2026-08-01",
  "data": {
    "wallets": [
      {
        "id": "7c1e…",
        "label": "Main USDT",
        "chain": "TRC20",
        "asset": "USDT",
        "address": "TXYZ…",
        "destination_tag": null,
        "status": "active",
        "is_payout_wallet": true,
        "created_at": "2026-09-01T10:00:00.000Z",
        "archived_at": null
      }
    ]
  }
}

Errors

403 capability_not_enabled when the payout_wallets capability is not granted. 503 temporarily_unavailable for a transient failure. 500 internal_error otherwise.