Idempotency

Every money-moving merchant request must include a unique idempotency key. Reuse the same key only when retrying the exact same request body.

When To Use It

  • Required for merchant public API calls that create payments, wallet movements, or giftcard redemption.
  • Recommended for user-initiated funding, withdrawals, and internal transfer requests.
  • Critical for poor-network retry flows on mobile to prevent duplicate debits.