Guide
Idempotency
Retry writes safely without double-creating cards, keys, webhooks or corrections.
Model
AICardAPI scopes idempotency by authenticated merchant, operation and idempotency key, then compares request hashes for replay or conflict behavior.
Conflict response
Reusing a key with a different body returns a conflict instead of executing a second command.
{"error":{"code":"idempotency_conflict","message":"request body differs"},"request_id":"req_demo"}