Gangguan jaringan bersifat ambigu: ConverterHQ mungkin sudah menerima request walau client tidak menerima response. Create dan handler harus aman untuk replay.
Create idempotent
Gunakan Idempotency-Key yang sama hanya untuk operasi logis yang sama dan client_reference_id untuk ID bisnis Anda. Jangan pakai key yang sama untuk body berbeda.
Retry transport
Retry timeout, reset, 429, dan 5xx retryable dengan exponential backoff serta jitter. Hormati Retry-After; jangan otomatis retry 4xx deterministik.
Retry Task
Retry eksekusi membuat attempt baru dan mempertahankan kegagalan sebelumnya. Upstream yang sudah sukses tidak dihapus bila hanya branch downstream yang perlu diulang.
Idempotensi webhook
Verifikasi signature sebelum side effect lalu deduplikasi dengan event_id. Respons cepat dan pindahkan kerja lambat ke queue sendiri.