Ön Provizyon (Pre-Authorization)

Fonları hemen çekmeden bir kartta rezerve etmek için bir ön provizyon işlemi gerçekleştirin.

POST/api/pre-authorization

İstek Parametreleri (Request Parameters)

Parametreler

Parametre	Zorunlu	Tip	Açıklama
orderId	Evet	string	Sipariş için benzersiz takip numaranız (örneğin, ORD-12345).
amount	Evet	number	İşlem tutarı (örneğin, 100.50).
currency	Evet	string	Para birimi kodu (örneğin, TRY).
cardHolderName	Evet	string	Kart sahibinin adı.
pan	Evet	string	Tam kart numarası (16 hane) (örneğin, 5421190122090656).
expiryMonth	Evet	string	Kartın son kullanma ayı (2 hane, örneğin, 04).
expiryYear	Evet	string	Kartın son kullanma yılı (2 hane, örneğin, 28).
cvv	Evet	string	Kart Güvenlik Kodu (örneğin, 916).
requestIp	Evet	string	İsteği yapan müşterinin IP adresi (örneğin, 192.168.1.1).
requestPort	Evet	number	İsteği yapan müşterinin port numarası (örneğin, 8080).
customerId	Hayır	string	Müşteri için isteğe bağlı benzersiz tanımlayıcı (örneğin, CUST-12345).

Örnek İstek

{
  "orderId": "ORD-12345",
  "amount": 100.50,
  "currency": "TRY",
  "cardHolderName": "John Doe",
  "pan": "5421190122090656",
  "expiryMonth": "04",
  "expiryYear": "28",
  "cvv": "916",
  "requestIp": "192.168.1.1",
  "requestPort": 8080,
  "customerId": "CUST-12345"
}

Yanıt (Response)

Ön provizyon ayrıntılarını içeren bir ApiPaymentResponse nesnesi döner.

Yanıt Alanları

Alan	Tip	Açıklama
paymentId	string	Ödeme işlemi için benzersiz kimlik (UUID).
orderId	string	Orijinal takip numaranız.
amount	number	İşlem tutarı.
installmentCount	number	Taksit sayısı.
currency	string	Para birimi kodu.
merchantCommission	number	Üye işyerinden alınan komisyon.
status	string	Ödeme durumu (örneğin, SUCCESS, FAILED, ENROLLED).
paymentDate	string	Ödeme tarihi ve saati (ISO formatı, örneğin, 2023-05-01T14:30:00Z).
cardHolderName	string	Kart sahibinin adı.
pan	string	Maskelenmiş kart numarası (örneğin, 411111******1111).
domInt	string	Yurt içi veya Yurt dışı işlem (DOM/INT).
cardScheme	string	Kart şeması (örneğin, VISA, MASTERCARD).
cardType	string	Kart tipi (örneğin, CREDIT, DEBIT).
loyaltyCode	string	Sadakat programı kodu (varsa).
externalTransactionId	string	Ödeme sağlayıcısından gelen işlem kimliği.
authCode	string	Ödeme sağlayıcısından gelen onay kodu.
resultCode	string	Ödeme sağlayıcısından gelen sonuç kodu.
resultMessage	string	Ödeme sağlayıcısından gelen sonuç mesajı.
customerId	string	Müşteri için benzersiz tanımlayıcı (sağlanmışsa).

Örnek Yanıt

Başarılı

{
  "paymentId": "123e4567-e89b-12d3-a456-426614174000",
  "orderId": "ORD-12345",
  "amount": 100.50,
  "installmentCount": 3,
  "currency": "TRY",
  "merchantCommission": 2.50,
  "status": "SUCCESS",
  "paymentDate": "2023-05-01T14:30:00Z",
  "cardHolderName": "John Doe",
  "pan": "411111******1111",
  "domInt": "DOM",
  "cardScheme": "VISA",
  "cardType": "CREDIT",
  "loyaltyCode": "GOLD123",
  "externalTransactionId": "EXT123456789",
  "authCode": "AUTH987654",
  "resultCode": "SUCCESS",
  "resultMessage": "Successful",
  "customerId": "CUST-12345"
}