List and Paginate Developer Payments

1. Overview & Purpose

The gateway supports listing payments with status and cursor parameters and returns a next cursor for subsequent pages.

2. Requirements & Setup

Use a valid secret key and request only the fields/pages required by the integration.

3. Step-by-Step Workflow

1. Call GET /api/v1/payments/.
2. Add supported filters such as status.
3. Read meta.next_cursor.
4. Request the next page only when needed.

4. Rules & Troubleshooting

Cursor pagination avoids repeatedly scanning the same historical dataset.

5. Verification & Next Steps

Persist cursors only for short-lived retrieval flows; treat them as opaque values.