Scheduled maintenanceScheduled maintenance: PayWise infrastructure maintenance is planned from Friday, October 9 at 7:00 p.m. ET through Monday, October 12 at 8:00 a.m. ET. Sandbox and Production services may experience intermittent interruptions during this period. Existing PayWise service URLs and SFTP hostnames will remain unchanged.
Skip to main content

Idempotency

Idempotency​

Use idempotency for all request types that can create or mutate state.

Required behavior​

  • Send a unique key per logical mutation attempt.
  • Reuse the same key only when retrying the same logical mutation.
  • Keep a stable payload for retries under one key.

transaction_id guidance​

  • Generate caller-side deterministic transaction IDs when possible.
  • Store (transaction_id, idempotency_key, outcome) in your system.
  • Treat duplicate accepted responses as success, not as a new operation.

Example key format​

paywise:<merchant_id>:<operation>:<uuid>