Kart Dışı Yöntemler — Checkout Formu

Checkout Formu kartın yanında hesabınızda açık olan kart dışı yöntemleri de gösterir: cüzdan, Faturana Yansıt ve Senetle Öde gibi. Alıcı yöntemi formda seçer, istenen bilgiyi girer ve yönteme göre telefonuna gelen kodla ödemeyi onaylar.

Bu sayfa Checkout Formu yolu içindir. Kart dışı yöntem çağrılarını (POST /payments/form/payment ve aksiyon onayı) Checkout Form SDK'sı alıcının tarayıcısından kendisi yapar. Sizin ek kod yazmanız gerekmez: yazacağınız kod, kartla ödemedeki gibi sunucunuzda intent oluşturmak ve formu sayfanıza mount etmektir → Checkout Formu.

Ödemeyi kendi sunucunuzdan başlatıyorsanız bu sayfa sizin için değildir → Payment.

Nasıl çalışır

Yöntemleri forma açma

• Panelde Ödeme → Form Ayarları ekranında yöntem grubunu açın ve bağlı sağlayıcıyı seçin. Formda yalnız açık olan ve en az bir sağlayıcısı bağlı olan yöntemler gösterilir.
• Form, GET /payments/methods ile aynı listeyi kullanır. Hangi yöntemlerin formda görüneceğini sunucunuzdan bu uçla kontrol edebilirsiniz.
• Bir intent'te gösterilecek yöntemleri daraltmak için intent'te settings.paymentMethods gönderin, örneğin ["card", "mobile_billing"]. Bu alan panelde kapalı bir yöntemi açamaz, yalnız daraltır.
• Intent'i "preauth": true ile oluşturduysanız formda yalnız ön provizyonu destekleyen yöntemler ve sağlayıcılar gösterilir → Ön Provizyon.
• Intent'i "paymentMethod": "WALLET" ile oluşturduysanız ödeme cüzdana sabitlenir: form doğrudan cüzdanla açılır, kartla ya da başka bir yöntemle ödenemez. walletProvider ile cüzdanı da önceden seçebilirsiniz.
• Intent'i "paymentMethod": "PROMISSORY_NOTE" ile oluşturursanız ödeme senede sabitlenir. Vade planını intent'te promissoryNote.schedule ile verebilirsiniz; vermezseniz alıcı senet sayısını seçer → Senetle Öde — Checkout Formu ile.

Bir siparişi birden fazla yönteme bölerek ödetmek için (ör. iki kart ve Faturana Yansıt): Parçalı Ödeme.

Sıra ve formda gösterilen sağlayıcılar

Panelde Ödeme → Form Ayarları ekranında:

• Yöntem sekmelerini sürükleyerek sıralarsınız. Form sekmeleri bu sırayla gösterir.
• Kart dışı her yöntemin Ödeme seçenekleri listesinde sağlayıcıları sürükleyerek sıralarsınız. Form seçenekleri bu sırayla gösterir.
• Her sağlayıcıyı formda gösterilsin anahtarıyla formda açıp kapatırsınız.

Sıra kuralları:

• Sıra vermediyseniz yöntemler ve sağlayıcılar varsayılan sırayla gelir; bkz. Yöntemleri Listeleme › Sıra.
• Sonradan bağladığınız sağlayıcı yönteminin sırasının sonuna eklenir. Bağlantısını kapattığınız sağlayıcı sıradan düşer.
• Sıra test ve canlı ortamda aynıdır.
• Form, panel ve GET /payments/methods aynı sırayı kullanır.

Formda kapalı sağlayıcı:

• Yalnız formda gizlenir. GET /payments/methods listesinde görünmeye devam eder ve POST /payments/direct/payment ile kullanılabilir. Sağlayıcıyı her yerde kapatmak için sağlayıcı bağlantısını kapatın.
• Formdan bu sağlayıcıyla ödeme başlatılamaz: istek 422 payment.provider.disabled_in_form alır.
• Yöntemin formda açık hiçbir sağlayıcısı kalmadıysa yöntem formda görünmez. Bakımdaki sağlayıcı da formda görünmez.

Sağlayıcı seçimi

Formda kart dışı her yöntemde sağlayıcıyı alıcı seçer; Faturana Yansıt dahil.

• Formda birden fazla sağlayıcı açıksa form seçenekleri sizin sıranızla, sağlayıcının logosu ve adıyla listeler; alıcı birini seçer. Logo yoksa sağlayıcının adı gösterilir.
• Tek sağlayıcı açıksa seçici gösterilmez. Sağlayıcının logosu (yoksa adı) görünür ve ödeme o sağlayıcıyla yapılır.
• Form alıcıdan seçilen sağlayıcının istediği alanları alır ve seçilen sağlayıcının kodunu her zaman gönderir.
• Yöntem satırındaki providerSelectionMode formun davranışını değiştirmez. Bu alan yalnız Direct API'de providerCode gönderilmediğinde ne olacağını belirler → Yöntemleri Listeleme › Sağlayıcı seçimi.

Seçim tutmazsa:

• Sağlayıcı ödemeyi para hareket etmeden reddettiyse ve ödeme kaydı açık kaldıysa alıcı aynı ekranda başka bir sağlayıcı ya da yöntem seçebilir.
• Sonucu henüz belli olmayan bir deneme varken yeni seçim yapılamaz; form sonucu bekler.
• Bir ödemede en fazla 3 kez kart dışı yöntem seçilebilir. Sınır dolunca kart dışı seçim 409 payment.method.selection_attempts_exhausted alır; alıcı kartla ödeyebilir.

Alıcının gördüğü adımlar

Faturana Yansıt

Cüzdan

Senetle Öde

Alıcı Senetle Öde'yi seçer, sizin verdiğiniz vade planını görür ya da senet sayısını seçer ve borçlu bilgilerini (gerekiyorsa kefilleri de) girer. Kod ya da yönlendirme yoktur: senetler anında düzenlenir ve form sonucu gösterir. Adımların ayrıntısı: Senetle Öde — Alıcının gördüğü adımlar.

Sonuç

• Kart dışı yöntemlerde alıcının tarayıcısı callbackUrl adresinize yönlendirilmez; sonuç formda gösterilir. Siparişi payment.captured webhook'una ya da GET /payments/:id sorgusuna göre kapatın.
• Ret para hareket etmeden geldiyse ve ödeme kaydı açık kaldıysa form alıcıya başka bir sağlayıcı ya da yöntem sunar.
• Ödeme FAILED olduysa aynı intent'le yeniden ödeme yapılamaz; alıcı yeniden ödemek isterse yeni intent oluşturun.
• Sonuç sağlayıcıyla doğrulanıyorsa form bunu bekleme mesajıyla gösterir; kesin sonuç webhook ile gelir.

Uç başvurusu — POST /payments/form/payment

Bu bölüm başvuru içindir; uçları SDK çağırır.

• Tutar, sepet, alıcı ve callbackUrl bu gövdede yoktur; intent'ten okunur. Gönderilirse istek 400 VALIDATION_ERROR alır.
• Kodun onayı ve tekrar gönderimi Payment sayfasındaki aksiyon uçlarıyla yapılır; formdan çağrıda gövde imza yerine token (ve gerekirse checkoutSessionProof) taşır.
• Yanıt biçimi Payment — Yanıt ile aynıdır.

{
  "token": "eyJhbGciOi…",
  "paymentMethod": "MOBILE_BILLING",
  "mobileBilling": { "providerCode": "<providerCode>", "gsmNumber": "+905321234567" },
  "browserFingerprint": "…",
  "paymentChannel": "WEB"
}

Hatalar

Form bu hataları alıcıya anlaşılır bir mesajla gösterir. Kodlar destek ve kayıt incelemesi içindir.

Kod onayı ve tekrar gönderme hataları: Payment — Hata kodları.

Hata kodları

Webhook'lar

Olayların data'sında paymentMethod (ör. MOBILE_BILLING, WALLET, PROMISSORY_NOTE) ve ödemeyi yürüten sağlayıcının providerCode'u bulunur. Senetlerin vadedeki sonuçları ayrı olaylarla gelir → Senetle Öde — Webhook'lar. Teslimat ve imza doğrulama → Webhook'lar.

Sonraki adımlar

• Checkout Formu — intent oluşturma ve form ayarı override'ları
• Kartla Ödeme — 2D ve Kartla Ödeme — 3D Secure — formda kart
• Payment — aynı yöntemler Direct API'den, yöntem listesi ve hata kodları
• Parçalı Ödeme — bir siparişi birden fazla kart ve yöntemle ödetme