Skip to main content
Network failures happen. When a request times out, you cannot tell whether PapelShip created the invoice. Idempotency keys let you retry safely.

​
How it works

Add an Idempotency-Key header to a create request. If you send the same key again, PapelShip returns the original result instead of creating a second invoice or deposit address.

​
Supported endpoints

​
Best practices

  • Generate one UUID v4 per order, not per request.
  • Store the key with your order so every retry reuses it.
  • Never reuse a key for a different order or amount.