Ana içeriğe atla
Payment intent, siparişiniz için canonical ödeme kaydıdır. Her POS denemesi ayrı ve değişmez attempt kaydıdır; merchant entegrasyonu attempt yerine intent durumunu izlemelidir.

​
Intent durumları

​
Terminal ve geçici durumlar

pending, processing ve requires_3ds geçici durumlardır. succeeded, failed, unknown, canceled, partially_refunded ve refunded operasyonel karar gerektiren kalıcı durumlardır. unknown finansal olarak terminal kabul edilmez; fakat otomatik failover için durdurucu durumdur.

​
Idempotency anahtarı

Intent oluşturma ve iade çağrılarında Idempotency-Key zorunludur. Anahtarı merchant operasyonuna bağlayın:
Aynı iş isteğinin network retry’larında aynı anahtarı kullanın. Farklı tutar veya farklı sipariş için anahtarı yeniden kullanmayın. Anahtar firma kapsamı içinde benzersizdir.

​
Sipariş durumunu güncelleme

Webhook tekrarlı gelebilir ve status sorgusu webhook’tan önce veya sonra sonuçlanabilir. Merchant tarafında intent ID ve event ID üzerinden idempotent işleyin. Aynı succeeded sonucunda siparişi, stoğu veya faturayı ikinci kez oluşturmayın.

İlgili konular

Ödeme oturumu entegrasyonuİptal ve iadeHatalar ve güvenli retryLimitler ve operasyonel izleme3DS ödeme yaşam döngüsü