Idempotency
Safely retry a request that creates or moves money without charging a customer or sending a payout twice.
Sending Idempotency-Key
Pass an Idempotency-Key header (8 to 120 characters: letters, digits and - _ : .) on requests that create or move money: creating a checkout session or a charge, charging a saved card, asking for and debiting a mandate, refunds, accepting or returning a held transfer, recording an offline invoice payment, and payouts. rafiqPay keeps the status code and response body for 24 hours. Other routes ignore the header.
Repeating the same key with the same request returns the original response with the header Idempotent-Replayed: true. If the first request is still running, the answer is 409: wait, then retry. Using the same key for a different request is refused with 422. Without the header, a request simply runs.