Idempotency

curl -X POST https://api.otim.com/v0/transfers \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-here" \
  -d '{
    "sourceAccountId": "acc_01JA1B2C3D4E5F6G7H8J9K0L",
    "destinationAccountId": "acc_02XY9Z8W7V6U5T4S3R2Q1P0N",
    "amount": "100.00"
  }'

​

How it works

• If a request with the same Idempotency-Key has already been processed, the API returns the original response without executing the operation again.
• Idempotency keys are scoped to your Platform and expire after 24 hours.
• Keys can be any unique string up to 256 characters. UUIDs are a good choice.

​

When to use idempotency keys

• Creating transfers to prevent duplicate payments.
• Creating Accounts or Entities to prevent duplicate resources if a network timeout occurs.