Payment intents
List payment intents
Payment intents of your account in the key's mode, newest first: the ones you created and the ones your terminals opened.
GET
/v1/payment_intentsscope payments:readQuery parameters
limitintegerdefault 20Page size, 1-100.
cursorstringThe
next_cursorof the previous page. Omit for the first (newest) page. Up to 1024 characters.created_gtestring (date-time)Only objects created at or after this time (ISO 8601).
created_ltstring (date-time)Only objects created before this time (ISO 8601).
terminalstringOnly intents of this terminal (
tml_…).sourcestringOne of:
api,terminalWho created the intent: your server (
api) or the POS (terminal).
Headers
ZyloPay-VersionstringPin the request to an API version (2026-09-28). Defaults to the version the API key was created with.
Returns
HTTP 200 with a list object: data holds up to limit payment intent objects, newest first; has_more and next_cursor drive pagination.
Errors
| Status | Meaning |
|---|---|
400 | Invalid request (invalid_request_error / idempotency_error). |
401 | Missing, invalid, expired or revoked API key (authentication_error). |
403 | The key lacks the scope, the IP is not allowed, or the account is disabled (permission_error). |
429 | Rate limit reached for this key (rate_limit_error); see Retry-After. |
500 | Internal error (api_error). Retry with the same Idempotency-Key. |
Branch on error.code. Every code is listed in error codes.
Example request
curl "https://zylopay-api.fly.dev/api/v1/payment_intents?limit=20&source=api" \
-H "Authorization: Bearer $ZYLOPAY_SECRET_KEY"Example response
{
"object": "list",
"data": [
{
"id": "pi_3f2c9e1a7b6d4c0e9f8a1b2c3d4e5f60",
"object": "payment_intent",
"livemode": false,
"amount": 2500000,
"currency": "usdc",
"status": "succeeded",
"terminal": "tml_ZP-4821-K",
"order_id": "A7K2Q9XZ",
"description": "Table 12",
"metadata": {
"pos_order": "48213"
},
"source": "api",
"payment": "pay_1042",
"tx_hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"next_action": null,
"last_payment_error": null,
"cancellation_reason": null,
"canceled_at": null,
"network": "testnet",
"expires_at": "2026-09-28T14:04:11.000Z",
"created": "2026-09-28T14:02:11.000Z"
}
],
"has_more": false,
"next_cursor": null
}