Kayıtlı Kartlar (Saved Cards)

payment.method: "saved_card" ile ödenen siparişler, kurumunuz için daha önce kasaya (vault) alınmış bir kartı tahsil eder. Partner API hiçbir zaman ham kart verisi kabul etmez; yalnızca bir savedCardId tüketir.

Kart Yaşam Döngüsü

  1. Kasaya alma (Vaulting) -- Kart, partner paneli web uygulaması üzerinden kaydedilir. Kayıt sırasında ödeme sağlayıcısı (NestPay) üzerinden 3D Secure ile tek seferlik bir kart doğrulaması yapılır; kart bilgileri doğrudan sağlayıcıya gider ve kasa jetonu (vault token) olarak saklanır. Kart kaydı API anahtarı yüzeyinde kullanılamaz.
  2. Kullanım -- Kart kasaya alındıktan sonra panel, kartın savedCardId değerini (bir UUID) gösterir. Sipariş oluştururken bu değeri payment.savedCardId olarak gönderin. Bu şekilde yapılan tahsilatlar kart sahibinin işlem anında bulunmasını gerektirmez.
  3. Kaldırma -- Kartlar partner panelinden kaldırılabilir. Kaldırılmış bir karta atıfta bulunan siparişler 404 ile başarısız olur.

Kurallar

  • savedCardId sizin kurumunuza ait olmalıdır. Bilinmeyen veya başka bir kuruma ait ID'ler 404 döner ve hiçbir idempotency kaydı harcanmaz.
  • payment.method değeri saved_card olduğunda savedCardId zorunludur; gönderilmezse 400 döner.
  • Sandbox modunda kart tahsil edilmez; biçimi doğru olan her istek simüle edilmiş bir sonuçla onaylanır.

İstek ve yanıt detayları için Sipariş Oluşturma bölümüne bakın.