Sigorta Firmaları — Kart Token
Sigorta firmaları için özel kart token oluşturma rehberi. İlk 8 / Son 4 / TCKN formatında, son kullanma tarihi ve CVV olmadan token oluşturma.
Bu entegrasyon yöntemi yalnızca sigorta firmaları için geçerlidir. Kullanabilmek için satış danışmanınıza sigorta entegrasyonu kullanacağınızı belirtmeniz ve özel yetkinin tanımlanmasını talep etmeniz gerekir.
Sigorta firmalarında kart token oluşturma işlemi standart akıştan farklıdır. Kart numarası ilk 8 / son 4 / TCKN formatında iletilir; son kullanma tarihi ve CVV bilgisi gerekmez.
Kart Numarası Formatı
Standart 16 haneli kart numarası yerine aşağıdaki format kullanılır:
{İlk8Hane}******{Son4Hane}Örnek:
| Alan | Değer |
|---|---|
| Kartın ilk 8 hanesi | 45678912 |
| Kartın son 4 hanesi | 3456 |
Gönderilecek CardNumber | 45678912******3456 |
Gerekli Alanlar
| Alan | Zorunlu | Açıklama |
|---|---|---|
CardNumber | Evet | İlk 8 / son 4 / TCKN formatında kart numarası |
Tckn | Evet | Kart sahibinin T.C. Kimlik Numarası |
PublicKey | Evet | Üye işyerine ait açık anahtar |
Nonce | Evet | Benzersiz istek kimliği |
Signature | Evet | HMAC-SHA256 imzası |
ConversationId | Evet | İstek takip numarası |
MerchantNumber | Evet | Üye işyeri numarası |
Sigorta entegrasyonunda ExpireMonth, ExpireYear ve Cvv alanları gönderilmez.
İmza Oluşturma
Bu endpoint'i çağırmadan önce PublicKey, Nonce, Signature ve ConversationId değerlerini hazırlamanız gerekir.
Aşağıdaki butonu kullanarak bu değerleri otomatik doldurabilirsiniz.
Detaylı bilgi için Kimlik Doğrulama rehberine bakın.
Örnek İstek
POST /v1/Tokens
Content-Type: multipart/form-data
CardNumber=45678912******3456
Tckn=12345678901
PublicKey=your-public-key
Nonce=1770629965755
Signature=dZspDJX18zdC1MnX4d0mhIX0F3IitK0+DQb5ZyxqR3U=
ConversationId=conv-001
MerchantNumber=000001{
"cardToken": "w2maVeYtMJeQ8lMeB0RLbzZuHt+H5OWGywvTRphsu5k=",
"signature": "RYYzgryrAzTXxVK7Kor2tDfDsrhn851Efrv94iuITDo=",
"isSucceed": true,
"conversationId": "conv-001"
}Dönen cardToken değerini ödeme akışının sonraki adımlarında kullanın.