Appearance

Örnek İstek & Yanıt ​

3DS PreSale (Ön Provizyon) işlemi için, istek ve yanıt örneğini aşağıda bulabilirsiniz.

Endpoint ​

POST /api/ThreeD/PreSale

İstek Gövdesi (Request Body) ​

http
POST/api/ThreeD/PreSale
Headers:
  x_client_token: your_client_token_here  
  x_nonce: bd992e36-7069-4d55-9d73-7c1ec6585652
  x_timestamp: 20251230145732
  x_signature: generated_signature_hash
  Content-Type: application/json

{
    "orderId": "6cda0c67-21c9-4539-a2e3-a7e8b38a6c8a",
    "cardNo": "5128030099001813",
    "expiry": 3312,
    "cvv2": "000",
    "amount": 12000,
    "currency": 949,
    "installmentCount": 3,
    "requestType": "3DS-PAY",
    "cardHolderIp": "188.132.138.70",
    "merchantIp": "188.132.138.71",
    "subMerchantIp": "188.132.138.72",
    "lang": "TR",
    "callbackUrl": "https://api.ornekfirma.com/odeme/callback",
    "returnUrl": "https://www.ornekfirma.com/odeme/sonuc",
    "cardholderName": "Test cardholder name",
    "cardholderEmail": "test@email.com",
    "additionalInfo": "no: 123456789",
    "invoiceInfo": "test deneme"
}

Başarılı Yanıt (HTTP 200) ​

json
{
    "state": 1,
    "result": {
        "resultCode": null,
        "procReturnCode": null,
        "resultMessage": "",
        "returnUrl": "https://www.ornekfirma.com/odeme/sonuc",
        "processId": "01e8eb40-38c5-4ae0-a64e-1b0d4a01318a",
        "token": "5+s+/ONC3/zLp4LW1ipIZ19thQa8/+bnlt77DqHSelfFOgF+ri3PL9iWnI1wYw4a",
        "htmlContent": "PCFET0NUWVBFIGh0bWwgU1lTVEVNICdhYm91dDpsZWdhY3ktY29tcGF0Jz4KPGh0bWwgY2xhc3M9J25vLWpzJyBsYW5nPSdlbicgeG1sbnM9J2h0dHA6Ly93d3cudzMub3JnLzE5OTkveGh0bWwnPgo8aGVhZD4KPG1ldGEgaHR0cC1lcXVpdj0nQ29udGVudC1UeXBlJyBjb250ZW50PSd0ZXh0L2h0bWw7IGNoYXJzZXQ9dXRmLTgnLz4KPG1ldGEgY2hhcnNldD0ndXRmLTgnLz4KPHRpdGxlPjNEIFNlY3VyZSBQcm9jZXNzaW5nPC90aXRsZT4KPC9oZWFkPgo8Ym9keT4KPGRpdiBpZD0nbWFpbic+CjxkaXYgaWQ9J2NvbnRlbnQnPgo8ZGl2IGlkPSdvcmRlcicgc3R5bGU9J3RleHQtYWxpZ246IGNlbnRlcjsnPgo8aW1nIHNyYz0naHR0cHM6Ly9lbXZ0ZHMtcHJlcHJvZC5ia210ZXN0LmNvbS50ci9zdGF0aWMvaW1nL3ByZWxvYWRlci5naWYnIGFsdD0nUGxlYXNlIHdhaXQuLicvPgo8ZGl2IGlkPSdmb3JtZGl2Jz4KPHNjcmlwdCB0eXBlPSd0ZXh0L2phdmFzY3JpcHQnPgpmdW5jdGlvbiBoaWRlQW5kU3VibWl0VGltZWQoZm9ybWlkKQp7CnZhciB0aW1lcj1zZXRUaW1lb3V0KGZ1bmN0aW9uKCkge2hpZGVBbmRTdWJtaXQoZm9ybWlkKX0sMTApOwp9CgpmdW5jdGlvbiBoaWRlQW5kU3VibWl0KGZvcm1pZCkKewp2YXIgZm9ybXg9ZG9jdW1lbnQuZ2V0RWxlbWVudEJ5SWQoZm9ybWlkKTsKCWlmIChmb3JteCE9bnVsbCkKCXsKCQlmb3JteC5zdHlsZS52aXNpYmlsaXR5PSdoaWRkZW4nOwoJCWZvcm14LnN1Ym1pdCgpOwoJfQp9Cjwvc2NyaXB0Pgo8ZGl2Pgo8Zm9ybSBpZD0ndGhyZWVEU1NlcnZlcldlYkZsb3dTdGFydEZvcm0nIG5hbWU9J3RocmVlRFNTZXJ2ZXJXZWJGbG93U3RhcnRGb3JtJyBtZXRob2Q9J1BPU1QnIGFjdGlvbj0naHR0cHM6Ly9lbXZ0ZHMtcHJlcHJvZC5ia210ZXN0LmNvbS50ci90ZHMvcmVzdWx0Rmxvdyc+CjxpbnB1dCB0eXBlPSdoaWRkZW4nIG5hbWU9J3RocmVlRFNTZXJ2ZXJXZWJGbG93U3RhcnQnIHZhbHVlPSdleUpoYkdjaU9pSklVekkxTmlKOS5ld29nSUNKMGFISmxaVVJUVTJWeWRtVnlWMlZpUm14dmQxTjBZWEowSWlBNklIc0tJQ0FnSUNKaFkzRjFhWEpsY2tsRUlpQTZJQ0l4TWlJc0NpQWdJQ0FpZEdoeVpXVkVVMU5sY25abGNsUnlZVzV6U1VRaUlEb2dJamMyTW1FelpUWmxMV1F3WmpndE5EVTRNaTFpTVdWbUxXRXhOVFk1WlRrMFlqTTVZaUlzQ2lBZ0lDQWlkR2h5WldWRVUxSmxjWFZsYzNSdmNsUnlZVzV6U1VRaUlEb2dJakF4WlRobFlqUXdMVE00WXpVdE5HRmxNQzFoTmpSbExURmlNR1EwWVRBeE16RTRZU0lzQ2lBZ0lDQWlkR2x0WlZwdmJtVWlJRG9nSWxWVVF5c3dNem93TUNJc0NpQWdJQ0FpZEdsdFpWTjBZVzF3SWlBNklDSXlNREkxTURreE5qRTNNRFV5TXlJc0NpQWdJQ0FpZG1WeWMybHZiaUlnT2lBaU1TNHhMakFpQ2lBZ2ZRcDkuUE9kTVE4bk9QS2lZVjVEc3BnSkNrdTZEUHUyQkdESDR6dnI3OWlTcFVVYycvPgo8aW5wdXQgdHlwZT0naGlkZGVuJyBuYW1lPSdicm93c2VyQ29sb3JEZXB0aCcgdmFsdWU9JycvPgo8aW5wdXQgdHlwZT0naGlkZGVuJyBuYW1lPSdicm93c2VyU2NyZWVuSGVpZ2h0JyB2YWx1ZT0nJy8+CjxpbnB1dCB0eXBlPSdoaWRkZW4nIG5hbWU9J2Jyb3dzZXJTY3JlZW5XaWR0aCcgdmFsdWU9JycvPgo8aW5wdXQgdHlwZT0naGlkZGVuJyBuYW1lPSdicm93c2VyVFonIHZhbHVlPScnLz4KPGlucHV0IHR5cGU9J2hpZGRlbicgbmFtZT0nYnJvd3NlckphdmFzY3JpcHRFbmFibGVkJyB2YWx1ZT0nJy8+CjxpbnB1dCB0eXBlPSdoaWRkZW4nIG5hbWU9J2Jyb3dzZXJKYXZhRW5hYmxlZCcgdmFsdWU9JycvPgo8aW5wdXQgdHlwZT0naGlkZGVuJyBuYW1lPSdicm93c2VyTGFuZ3VhZ2UnIHZhbHVlPScnLz4KPHNjcmlwdCB0eXBlPSd0ZXh0L2phdmFzY3JpcHQnPgpoaWRlQW5kU3VibWl0VGltZWQoJ3RocmVlRFNTZXJ2ZXJXZWJGbG93U3RhcnRGb3JtJyk7Cjwvc2NyaXB0Pgo8c2NyaXB0IHR5cGU9J3RleHQvamF2YXNjcmlwdCc+CmZ1bmN0aW9uIGNvbGxlY3RCcm93c2VySW5mb3JtYXRpb24oZm9ybWlkKQp7Cgl2YXIgZm9ybT1kb2N1bWVudC5nZXRFbGVtZW50QnlJZChmb3JtaWQpOwoJaWYgKGZvcm0hPW51bGwpCgl7CgkJaWYgKGZvcm1bJ2Jyb3dzZXJKYXZhc2NyaXB0RW5hYmxlZCddIT1udWxsKQoJCXsKCQkJLy8gaWYgdGhpcyBzY3JpcHQgcnVucyBqcyBpcyBlbmFibGVkCgkJCWZvcm1bJ2Jyb3dzZXJKYXZhc2NyaXB0RW5hYmxlZCddLnZhbHVlPSJ0cnVlIjsKCQl9CgkJaWYgKGZvcm1bJ2Jyb3dzZXJKYXZhRW5hYmxlZCddIT1udWxsKQoJCXsKCQkJZm9ybVsnYnJvd3NlckphdmFFbmFibGVkJ10udmFsdWU9bmF2aWdhdG9yLmphdmFFbmFibGVkKCk7CgkJfQoJCWlmIChmb3JtWydicm93c2VyQ29sb3JEZXB0aCddIT1udWxsKQoJCXsKCQkJZm9ybVsnYnJvd3NlckNvbG9yRGVwdGgnXS52YWx1ZT1zY3JlZW4uY29sb3JEZXB0aDsKCQl9CgkJaWYgKGZvcm1bJ2Jyb3dzZXJTY3JlZW5IZWlnaHQnXSE9bnVsbCkKCQl7CgkJCWZvcm1bJ2Jyb3dzZXJTY3JlZW5IZWlnaHQnXS52YWx1ZT1zY3JlZW4uaGVpZ2h0OwoJCX0KCQlpZiAoZm9ybVsnYnJvd3NlclNjcmVlbldpZHRoJ10hPW51bGwpCgkJewoJCQlmb3JtWydicm93c2VyU2NyZWVuV2lkdGgnXS52YWx1ZT1zY3JlZW4ud2lkdGg7CgkJfQoJCXZhciB0aW1lem9uZU9mZnNldEZpZWxkPWZvcm1bJ2Jyb3dzZXJUWiddOwoJCWlmICh0aW1lem9uZU9mZnNldEZpZWxkIT1udWxsKQoJCXsKCQkJdGltZXpvbmVPZmZzZXRGaWVsZC52YWx1ZT1uZXcgRGF0ZSgpLmdldFRpbWV6b25lT2Zmc2V0KCk7CgkJfQoJCWlmIChmb3JtWydicm93c2VyTGFuZ3VhZ2UnXSE9bnVsbCkKCQl7CgkJCWZvcm1bJ2Jyb3dzZXJMYW5ndWFnZSddLnZhbHVlPW5hdmlnYXRvci5sYW5ndWFnZTsKCQl9Cgl9Cn0KY29sbGVjdEJyb3dzZXJJbmZvcm1hdGlvbigndGhyZWVEU1NlcnZlcldlYkZsb3dTdGFydEZvcm0nKTsKPC9zY3JpcHQ+Cjxub3NjcmlwdD4KPGRpdiBhbGlnbj0nY2VudGVyJz4KPGI+SmF2YXNjcmlwdCBpcyB0dXJuZWQgb2ZmIG9yIG5vdCBzdXBwb3J0ZWQhPC9iPgo8YnIvPgo8L2Rpdj4KPC9ub3NjcmlwdD4KPGlucHV0IHR5cGU9J3N1Ym1pdCcgbmFtZT0nc3VibWl0QnRuJyB2YWx1ZT0nUGxlYXNlIGNsaWNrIGhlcmUgdG8gY29udGludWUnLz4KPC9mb3JtPgo8L2Rpdj4KPC9kaXY+CjwvZGl2Pgo8ZGl2IGlkPSdjb250ZW50LWZvb3Rlcic+Cjxici8+CjwvZGl2Pgo8L2Rpdj4KPC9kaXY+CjwvYm9keT4KPC9odG1sPgo"
    }
}