Bulk Payment Initialization

1. Overview & Purpose

The published guide supports POST /api/v1/payments/bulk/ and describes synchronous handling for small batches and queued processing for larger batches.

2. Requirements & Setup

Each payment should have its own stable idempotency key where safe retries matter.

3. Step-by-Step Workflow

1. Build the payments array.
2. Submit the batch endpoint.
3. Store the batch reference.
4. Poll the batch status endpoint or consume the completion event.

4. Rules & Troubleshooting

Large batches may be queued rather than completed inside the request cycle.

5. Verification & Next Steps

Design the application so a processing batch can remain pending without duplicate submissions.