Ana içeriğe geç

Idempotency

Kart ödemesi (/partner/1.0/pos/card/pay) gibi tahsilat uçları, isteğin bir kez işlenmesini garanti etmek için bir idempotency anahtarı kabul eder.

Kullanım​

Anahtar, istek gövdesindeki idempotencyKey alanı ile gönderilir. Verilmezse sunucu otomatik üretir.

curl -X POST https://<host>/partner/1.0/pos/card/pay \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
    "referenceCode": "ORD-1001",
    "idempotencyKey": "pay-ORD-1001",
    "paymentMethod": "CARD",
    "amount": 100.00,
    "currency": "TRY"
  }'

Davranış​

  • Aynı idempotencyKey ile yapılan tekrar istek, ilk isteğin sonucunu döndürür; işlem yeniden yürütülmez.
  • Anahtarı merchant başına benzersiz tutun.

Önerilen Pattern​

{operation}-{referenceCode} örneği:

pay-ORD-1001