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öntem | Nasıl | Token nerede döner |
|---|---|---|
| Ödemeyle birlikte | secure-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ı. |
| Ödemesiz | create-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şul | Sağ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 ait | Bö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 destekliyor | Bu ö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.
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
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,
));
const payment = await client.regularPayment({
reference: 'SIP-10235',
amount: '120.00',
installmentNumber: 1,
ip: req.ip,
customer,
savedCardToken,
});
from odemehub.request import RegularPayment
payment = client.regular_payment(RegularPayment(
reference="SIP-10235",
amount="120.00",
installment_number=1,
ip=request.remote_addr,
customer=customer,
saved_card_token=saved_card_token,
))
import com.odemehub.request.RegularPayment;
var payment = client.regularPayment(RegularPayment.builder()
.reference("SIP-10235")
.amount("120.00")
.installmentNumber(1)
.ip(request.getRemoteAddr())
.customer(customer)
.savedCardToken(savedCardToken)
.build());
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-cardbaşka bir kartı varsayılan yapar; önceki kartınis_defaultdeğerifalseolur.- 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-cards | Kartları token, müşteri referansı ya da tarih aralığıyla listeler. |
update-saved-card | Kartı varsayılan yapar. |
delete-saved-card | Kartı ödeme hesabından ve ödemehub'dan siler. |
Kart nesnesinin alanları: Kart nesnesi.