Ana içeriğe geç

Kayıtlı Kartlar

Kayıtlı kart, ödeme hesabının sağlayıcısında saklanan ve ödemehub'da bir token'la (saved_card.token) adlandırılan karttır. Yanıtlarda kartın yalnızca ilk 6–8 hanesi ve son 4 hanesi döner.

Kart, customer.reference ile adlandırılan müşterinin altında saklanır ve bu referansla bulunur. Müşteri, kart saklandığında bu referansla çalışma alanınıza kaydedilir ya da güncellenir. Müşterinin e-posta adresi eşleştirmede kullanılmaz; e-posta değişse de kartlar aynı müşteride kalır.

Çalışma alanınızda Kayıtlı Kartlar modülü açık olmalı ve ödeme hesabının sağlayıcısı kart saklamayı desteklemelidir.

Kart saklama​

YöntemNasılToken nerede döner
Ödemeyle birliktesecure-payment ya da regular-payment isteğinde card.should_save: true ve customer.reference. Kart yalnızca ödeme başarılı olursa saklanır.Regular: ödeme yanıtının saved_card alanı. Secure: retrieve-payments yanıtının saved_card alanı.
Ödemesizcreate-saved-card.Yanıtın saved_card alanı.
Abonelikİlk abonelik ödemesinde kart her zaman saklanır.retrieve-saved-cards ile listelenir.

Kart, çalışma alanının o anki modunda (test ya da canlı) saklanır.

Kayıtlı kartla ödeme​

secure-payment ya da regular-payment isteğinde card yerine transaction.saved_card_token gönderin. customer.reference, kartın saklandığı müşterinin referansı olmalıdır.

{
"transaction": {
"reference": "SIP-10235",
"saved_card_token": "2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f",
"amount": "120.00",
"installment_number": 1,
"ip": "85.105.10.20"
},
"customer": {
"reference": "musteri-88",
"billing_address": { "firstname": "Ahmet", "lastname": "Yılmaz", "email": "[email protected]", "phone": "05551112233", "address": "Kızılırmak Mah. Dumlupınar Blv. No:3", "district": "Çankaya", "province": "Ankara", "country": "TR" }
}
}

Kartın kabul edilmesi için:

KoşulSağlanmazsa (transaction.saved_card_token)
payment_provider_token gönderilmemişKayıtlı kartla ödemede ödeme hesabı gönderilmez; ödeme kartın saklandığı hesaptan alınır.
Kayıtlı Kartlar modülü açıkÇalışma alanınızda Kayıtlı Kartlar modülü kapalı.
Kart çalışma alanınıza aitBöyle bir kayıtlı kart bulunamadı.
customer.reference, kartın saklandığı müşterinin referansıKayıtlı kart bu müşteriye ait değil.
Kart, çalışma alanının şu anki modunda (test/canlı) saklanmışKayıtlı kart bu ortamda saklanmamış.
Kartın saklandığı ödeme hesabı silinmemişKartın kayıtlı olduğu ödeme hesabı silinmiş.
Hesabın sağlayıcısı kayıtlı kartla ödemeyi destekliyorBu ödeme hesabı kayıtlı kartla ödeme desteklemiyor.
card gönderilmemişKayıtlı kartla ödemede kart bilgisi gönderilmez. (transaction.saved_card_token alanında)

Kayıtlı kartla ödeme her zaman kartın saklandığı hesaptan alınır; yönlendirme kuralları ve varsayılan hesap uygulanmaz.

not

Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.

use Gurmehub\Odemehub\Request\RegularPayment;

$payment = $client->regularPayment(new RegularPayment(
reference: 'SIP-10235',
amount: '120.00',
installmentNumber: 1,
ip: $_SERVER['REMOTE_ADDR'],
customer: $customer,
savedCardToken: $savedCardToken,
));

card ile savedCardToken (Python'da saved_card_token) birlikte verilirse istek gateway'de 422 ile reddedilir; SDK'lar bunu istemci tarafında denetlemez.

Varsayılan kart​

  • Yeni saklanan kart müşterinin varsayılan kartı olur.
  • update-saved-card başka bir kartı varsayılan yapar; önceki kartın is_default değeri false olur.
  • Başarılı her kartlı ödemede kullanılan kayıtlı kart (abonelik ödemesi dahil) varsayılan olur.
  • Varsayılan kart silinirse müşterinin kalan kartlarından en son saklanan varsayılan olur.
  • Abonelik yenilemeleri varsayılan karttan çekilir.

Uçlar​

Uçİşlem
create-saved-cardÖdeme yapmadan kart saklar.
retrieve-saved-cardsKartları token, müşteri referansı ya da tarih aralığıyla listeler.
update-saved-cardKartı varsayılan yapar.
delete-saved-cardKartı ödeme hesabından ve ödemehub'dan siler.

Kart nesnesinin alanları: Kart nesnesi.