List payments
List the shop's transactions with optional filters.
/api/v1/paymentsSelect a stage to see what happens.
/payments- Authorization
- Bearer ••••••••
- Accept
- application/json
Prepare the request
Use credentials for the selected environment and complete the required parameters.
Illustrative flow · no data is sent
How this endpoint works
List the authenticated shop's transactions, paginated + filterable. Each tx returns `paymentMethodId` (the same 4-digit id you sent when creating it) — you can use it as a filter to fetch only the txs of a specific retailer (e.g. `?paymentMethodId=1003` for Walmart only). The legacy path `GET /api/v1/transactions` still works identically.
Request parameters
Expand a field to see its format and requirements.
limitinteger
1–100. Default 50.
offsetinteger
Default 0.
statusstring
completed · pending · failed · refunded · expired · chargeback.
paymentMethodIdstring
4-digit id from GET /api/v1/payment-methods. Returns the payments processed through that exact retailer, bank or native method (e.g. 1003 returns only Walmart MEX), whichever id was sent to create each payment. An id that only names a method and a country returns every payment of that method in that country.
countrystring
Payer's country. ISO-3 or ISO-2 interchangeably.
merchantOrderIdstring
Your own id saved when creating the charge — useful for disaster-recovery if you lose the txId.
methodstring
Legacy. Bucket slug (pix, spei, voucher, …). Use `paymentMethodId` for per-retailer precision.