API reference

Payments

The buyer payments bound to your intents, with their state on chain.

GET/api/v1/payments

Payments bound to your intents, newest first. Filter with status (protected, disputed, released, refunded) or intent; paginate with limit and starting_after.

curl "https://indeficient.com/api/v1/payments?intent=pi_test_…" \
  -H "Authorization: Bearer $PP_API_KEY"

GET/api/v1/payments/{id}

One payment, by its address on chain.

Response

{
  "object": "payment",
  "id": "6VoCXSvs49gnzC6ULszzsfuZdjxRv9wu8LvdmFLcY2Ac",
  "intent": "pi_test_k3v7q2mz5hxa4wde6rtn2bpy",
  "role": "primary",
  "status": "protected",
  "sender": "4Nb8FgSzmSz8htxwwdURvK98AhMQXhbuukbSXKdHdYai",
  "recipient": "GkphMxyen3SSuENVGSTrTRMuMuMEn99jowYXe5SNJea5",
  "amount": "25000000",
  "asset": "6gpWDzHJF36N3zxKJKFTGvR1WHF5uvTBqocNPytCmdQZ",
  "protectionPeriod": "sevenDays",
  "merchantReference": "order_1042",
  "late": false,
  "signature": "3wBmX9kqT7nVcR2hYpL5sJ8dF4gZ6aE1uQoW3iKxNbMtC7vP9yHrGjS2fDeA5LkUzXq8nRwT4mYbV6cJpHsF1aG",
  "createdAt": "2026-10-10T14:05:37.000Z",
  "protectionDeadline": "2026-10-17T14:05:37.000Z",
  "disputedAt": null,
  "settledAt": null,
  "checkedAt": "2026-10-10T14:10:02.000Z"
}

Field	Meaning
`id`	The payment’s address on chain.
`role`	`primary`, or `duplicate` for a second buyer’s payment of a paid intent.
`status`	The chain state as of `checkedAt`.
`sender`	The buyer’s wallet.
`late`	Paid after the intent expired or was canceled.
`signature`	The transaction that created it, when known.
`protectionDeadline`	Disputes can be opened until then; after it, the payment can be settled to the recipient.