Partners
Markdown

List a customer’s fiat orders

GET /api/v1/partner/customers/{customerId}/fiat-orders

Required scope: payments:read.

Returns only orders minted by this partner relationship. A partner can never see another partner’s orders (they share the merchant’s userId).

curl https://www.niftipay.com/api/v1/partner/customers/pc-1/fiat-orders \
  -H "Authorization: Bearer <partner_api_key>"

Response 200

{
  "request_id": "req-1",
  "api_version": "2026-08-01",
  "data": {
    "fiat_orders": [
      {
        "order_key": "1001",
        "status": "new",
        "amount_cents": 1000,
        "refunded_cents": 0,
        "chargeback_cents": 0
      }
    ]
  }
}

Every order carries refunded_cents and chargeback_cents, filled from our own records rather than from the processor, so reconciling a page of orders costs no provider calls. A chargeback reverses the whole order, so a disputed order shows its amount in chargeback_cents and 0 in refunded_cents — see Retrieve a fiat order.