Cards & Tokens

Kart saklama ve tokenizasyon, müşterilerin kart bilgilerini tekrar girmeden ödeme yapmasını sağlar. Paylox, kart bilgilerini güvenle tokenize eder.

Tokenizasyon Nedir?

Kart numarası ve hassas bilgiler, benzersiz bir token ile değiştirilir. Token ile ödeme yapabilirsiniz ama token'dan kart numarasını geri elde edemezsiniz.

5388 8800 0000 0055  →  tok_a1b2c3d4e5f6

Kart Saklama

İlk ödemede save_card: true parametresini gönderin:

{
  "session_id": "ses_xxx",
  "payment_type": "creditcard",
  "card_holder_name": "AHMET YILMAZ",
  "card_number": "5388880000000055",
  "expire_month": "12",
  "expire_year": "2030",
  "cvc": "000",
  "save_card": true
}

Başarılı yanıtta card_token döner:

{
  "success": true,
  "order_id": "ORD-xxx",
  "card_token": "tok_a1b2c3d4e5f6",
  "card_last_four": "0055",
  "card_brand": "mastercard"
}

Token ile Ödeme

Saklanan token ile yeni ödeme yapın:

{
  "session_id": "ses_xxx",
  "payment_type": "creditcard",
  "card_token": "tok_a1b2c3d4e5f6",
  "installment_count": "1"
}

Token Nesnesi

Alan	Tip	Açıklama
card_token	string	Benzersiz token kimliği
card_last_four	string	Kart numarasının son 4 hanesi
card_brand	string	Kart markası (visa, mastercard)
expire_month	string	Son kullanma ayı
expire_year	string	Son kullanma yılı

PAN Masking

API yanıtlarında kart numarası her zaman maskelenmiş olarak döner:

5388 88** **** 0055

Tam kart numarası hiçbir zaman saklanmaz veya gösterilmez.

uyarı

Token'ları güvenli bir şekilde saklayın. Token'lar kart numarası kadar hassas olmasa da, yetkisiz kişilerin erişimine karşı korunmalıdır.