The payment object

Settled payments (indexed from the chain).

EndpointsCopy Anchor Link

• GET /v1/payments: List payments
• GET /v1/payments/{id}: Retrieve a payment

AttributesCopy Anchor Link

idstring

Unique identifier (pay_…).

objectstring

livemodeboolean

true on mainnet (live key), false on testnet (test key).

amountinteger

Amount charged for the sale, in USDC atoms (6 decimals). The merchant receives all of it.

currencystring

amount_refundedinteger

Amount refunded so far (USDC atoms).

statusstring

One of: succeeded, partially_refunded, refunded

feesobject

Attributes of fees

acquirerinteger

POS acquirer fee (USDC atoms), paid by the payer on top of amount.

protocolinteger

ZyloPay protocol fee (USDC atoms), paid by the payer on top of amount.

cashbackinteger

Payer cashback funded from the fees (USDC atoms).

total_chargedinteger

What was pulled from the payer (amount + fees − instant cashback).

netinteger

What the merchant received (USDC atoms). Equals amount.

cashback_statusstring

One of: paid, accrued, none

paid: cashback paid to the payer in the settlement itself; accrued: credited for a later claim (older contract); none.

payerstring

Payer wallet address (lowercase).

order_idstring

Order ID written on-chain with the settlement.

terminalstring | null

Terminal that took the payment (tml_…).

payment_intentstring | null

The payment intent (pi_…) this payment settled.

payment_methodobject

Attributes of payment_method

typestring

credentialstring | null

One of: nfc_id, payment_token

Which pass credential the terminal read: the Smart Tap / VAS NFC ID, or a rotating payment token (QR). Null when the payment was not made through the relay.

split_groupstring | null

Split-payment group, when the sale was split across payers.

networkstring

One of: mainnet, testnet

chain_idinteger

One of: 143, 10143

Monad chain ID.

tx_hashstring | null

Settlement transaction hash on Monad.

block_numberinteger | null

log_indexinteger | null

settled_atstring (date-time) | null

Block time of the settlement.

createdstring (date-time)

When ZyloPay indexed the settlement.

ExampleCopy Anchor Link

{
  "id": "pay_1042",
  "object": "payment",
  "livemode": false,
  "amount": 2500000,
  "currency": "usdc",
  "amount_refunded": 0,
  "status": "succeeded",
  "fees": {
    "acquirer": 6250,
    "protocol": 6250,
    "cashback": 1250
  },
  "total_charged": 2512500,
  "net": 2500000,
  "cashback_status": "paid",
  "payer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
  "order_id": "A7K2Q9XZ",
  "terminal": "tml_ZP-4821-K",
  "payment_intent": "pi_3f2c9e1a7b6d4c0e9f8a1b2c3d4e5f60",
  "payment_method": {
    "type": "wallet_pass",
    "credential": "nfc_id"
  },
  "split_group": null,
  "network": "testnet",
  "chain_id": 10143,
  "tx_hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
  "block_number": 48213377,
  "log_index": 3,
  "settled_at": "2026-09-28T14:02:39.000Z",
  "created": "2026-09-28T14:02:40.000Z"
}