İstek Nesne Yapısı

3DS Pay Sale (Satış) API – Request Parametreleri

Ad	Tip	Uzunluk	Açıklama
orderId*	string	150	Üye işyeri tarafından oluşturulan benzersiz sipariş numarası.
cardNo*	string	19	Kart numarası (PAN).
expiry*	int	4	Kartın son kullanma tarihi (YYMM formatında).
cvv2	string	3	Kartın arka yüzündeki CVV güvenlik kodu.
amount*	long	12	İşlem tutarı (100 ile çarpılarak gönderilir. Örn: 5.21 TL → 521).
currency*	int	3	İşlem para birimi (949=TRY, 978=EUR, 840=USD, 826=GBP). Tam listeye buradan ulaşabilirsiniz.
requestType*	string	10	3DS-PAY: Kart sahibi doğrulaması ve ödeme işlemi birlikte yapılır.
pointAmount	long	12	Puan tutarı (100 ile çarpılarak gönderilir. Örn: 5.21 TL → 521).
installmentCount	int	2	Taksit adedi.
cardHolderIp	string	15	Kart sahibinin IP adresi.
merchantIp	string	15	Üye işyerinin, ödeme aracısının veya ödeme geçidinin IP adresi.
subMerchantIp	string	15	Alt üye işyeri IP adresi.
lang	string	2	Yanıt mesajı dili ("EN", "TR").
additionalInfo	string	200	Opsiyonel ek bilgi.
invoiceInfo	string	4000	Opsiyonel fatura bilgisi (base64 ile encode edilmiş JSON formatında gönderilir).
cardholderName	string	45	Kart sahibi adı ASCII formatında olmalıdır. ASCII dışı karakterler en yakın ASCII karakterine dönüştürülür. Dönüştürülemeyen karakterler "?" ile değiştirilir. Örn: "Lillı Celiné Никита Ödipus" → "Lilli Celine Nikita Odipus"
cardholderEmail	string	100	Kart sahibi e-posta adresi.
returnUrl	string	150	3DS işlemi sonrası yönlendirme URL’si. Boş bırakılırsa, onboarding sürecinde tanımlanmış URL kullanılır. (Detaylar için bknz. Non-3DS İşlem API)
callbackUrl	string	150	VPOS sistemi ile üye işyeri sistemi arasındaki mutabakat işlemleri için kullanılır. webhook/callback URL’si. Boş bırakılırsa onboarding sürecinde tanımlı URL kullanılır. (Detaylar için bknz. Non-3DS İşlem API)