Auth & access

Idempotency

Send an Idempotency-Key on every write to make retries safe.

Pierflow keeps each Idempotency-Key for 24 hours. Retries within that window return the original response — no duplicate enrollments, no double-charges.

Header#

http

Idempotency-Key: idem_enrl_20260601_amaka_silver

Designing keys#

Make keys deterministic for the request you're trying to perform. A good pattern: <purpose>_<date>_<entity>_<intent>.

Don't reuse keys across distinct intents

A key is bound to the request body. Sending a different body with the same key returns a 409. Use a fresh key for a genuinely new action.