Appearance

Örnek İstek & Yanıt ​

Tekrarlı (Recurring) Ödeme oluşturma işlemi için, istek ve yanıt örneğini aşağıda bulabilirsiniz.

Endpoint ​

POST /api/Recurring/CreateRecurring

3DS doğrulama ile başlatılan işlemler için örnek istek ve yanıt aşağıda verilmiştir. ​

İstek Gövdesi (Request Body) ​

http
POST/api/Recurring/CreateRecurring
Headers:
  x_client_token: your_client_token_here
  x_nonce: 0e72e797-3b4d-4c9e-be17-be453506108d
  x_timestamp: 20251209133409
  x_signature: generated_signature_hash
  Content-Type: application/json

{
  "orderId": "ORDER-2025-001234",
  "cardNo": "5400010000000004",
  "expiry": 1228,
  "cvv2": "123",
  "amount": 29900,
  "currency": 949,
  "period": "M",
  "interval": 3,
  "installmentCount": 12,
  "startDate": "2025-12-09T00:00:00",
  "secureType": "3DS",
  "returnUrl": "https://yourwebsite.com/payment/home",
  "callbackUrl": "https://yourwebsite.com/api/payment-notification",
  "lang": "TR",
  "additionalInfo": "{\"planName\":\"Premium Üyelik\",\"customerId\":\"CUST-789\"}"
}

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

json
{
  "state": 1,
  "result": {
    "recurringId": "5c26bded-17b5-4ed6-b960-f420b9d21744",
    "orderId": "ORDER-2025-001234",
    "processId": "bc065460-5dcc-4ff9-99d6-472183d28365",
    "authCode": null,
    "rrn": null,
    "cardMask": "54000100mmtkjk04",
    "resultCode": null,
    "procReturnCode": null,
    "resultMessage": "3DS müşteri doğrulama adımına yönlendiriliyor.",
    "token": "UPyBV5rtxlR12h6QHvSA+Kpx/2ocisuCADIZ/k3TxLfZhttvBkXA+97hw3uaVBAJ",
    "htmlContent": "PGJvZHk+PGZvcm0gYWN0aW9uPSdodHRwczovL2dvZ3V2ZW5saW9kZW1lLXByZXByb2QuYmttdGVzdC5jb20udHIvdHJveS9hcHByb3ZlJyAgbWV0aG9kPSdQT1NUJyBuYW1lPSdhY3NGb3JtJz48aW5wdXQgdHlwZT0naGlkZGVuJyBuYW1lPSdnb3JlcScgdmFsdWU9J2V5SnBaQ0k2SWpBd01USTJNalExTldKbFpTMW1NRFF6TFRSak1qVXRPR1prTmkwMFptRXdPVGMyT0Roa01ESWlMQ0owYVcxbElqb2lNakF5TlRFeU1Ea3hOalEwTWpRaUxDSjJaWEp6YVc5dUlqb2lNQzR3TXlJc0ltVjRjR2x5ZVNJNklqSTRNREVpTENKbmIxTjBZVzF3SWpvaVpYbEthR0pIWTJsUGFVcEpWWHBWZUUxcFNqa3VaWGxLZW1SWFNXbFBhVWwzVFVSQmQwMUVRWGROUkVWM1RWUlZNVTFxWTJsTVEwb3dZVmN4YkdJelZqQlZNbFpxWWpJMWEyTjVTVFpPUkUxNVRVUkJkMDFFUVhOSmJrcDJZa2RXZWtscWIybEphWGRwV2xob2QwbHFiM2hQUkVFMFRrUm5NMDlFV1RObVVTNUVPRkJ2VG5nelZXRnVNa2h5WlhwaldUWkNVR2xwTmtKamQzWXRUbTltUlhSWFpsOWtNMVpCZDNFemIyaEdaWGM0WWxaNVprNVlkRFpxUVhBNGFrWklURk5pVTBGdlZrZDBNRFpmYWtKWWRuSklNalp4WnlJc0ltMWhZeUk2SWs1aFlrNXJUMDlMTkVzMWVrTkJLelZFWlVsT1NtMU5PRmxEVldkNE0xQm1VWGQ0ZVZjNVZqa3lVRmRGUTJSVUswWk9RMVF3UWpkTUswTlBTak5yVG1OeWN6SmlTMEU1VEhkVFJWQnViM2RTZFVORFpuY3hkWGhLYTBRNFpuUTBNVnB2VjIxMlpWVkxMMWh3SzFaakx6bFJTRzVWZHpaakwybDVVVGhoUWt4YVpVUnlNM3BLY1dOSWF6bEROamN5YzFGQmVVWjVNMUZoTTBFMGVHUnhVV0UwWTBKa1duSnZOazlzTkZwUldYQnlRMVpTV2xGdlEwczRPRXRWUnpsT1JUTk1jbTVtUTNWSlVFVk5iVlIxYjFZeVUwOHZSWGd5VkhoNmJHaHZlbmsyU21aV0x6TXhNbmRPVUdacFR6ZExhMjFyWTJGeU55OVRPVWhRVldvdllWWTROVU01Tm1GUVRVOTVUa0V5VDA5emFuSjRUM1YyU2tWS1dHWTFhRlJWVFc1MVVXY3ZkRmxqU0c4NU0wWm5WblUwYVVaaFJrcGxka28wUldVdlFtZzFhazlRVTJWNmRGVkpRakJzT1VkTWVHcFRVMEl3UVQwOUluMD0nPjxpbnB1dCB0eXBlPSdzdWJtaXQnIHZhbHVlPSdzdWJtaXQnIHN0eWxlPSd2aXNpYmlsaXR5OmhpZGRlbic+PC9mb3JtPjwvYm9keT48c2NyaXB0IGxhbmd1YWdlPSdqYXZhc2NyaXB0Jz53aW5kb3cub25sb2FkID0gZnVuY3Rpb24gKCl7ZG9jdW1lbnQuZm9ybXNbJ2Fjc0Zvcm0nXS5zdWJtaXQoKTsgfTs8L3NjcmlwdD4="
  }
}

Kart güvenlik doğrulaması yapılmadan başlatılan işlemler için örnek istek ve yanıt aşağıda verilmiştir. ​

İstek Gövdesi (Request Body) ​

http
  POST/api/Recurring/CreateRecurring
  Headers:
  x_client_token: your_client_token_here
  x_nonce: 0e72e797-3b4d-4c9e-be17-be453506108d
  x_timestamp: 20251209133409
  x_signature: generated_signature_hash
  Content-Type: application/json
  
  {
    "orderId": "ORDER-2025-001234",
    "cardNo": "5400010000000004",
    "expiry": 1228,
    "cvv2": "123",
    "amount": 1000,
    "currency": 949,
    "installmentCount": 5,
    "period": "D",
    "interval": 1,
    "startDate": "2025-12-09T00:00:00",
    "secureType": "Non-3DS",
    "lang": "TR",
    "returnUrl": "https://yourwebsite.com/payment/home",
    "callbackUrl": "https://yourwebsite.com/api/payment-notification",
    "lang": "TR",
    "additionalInfo": "{\"planName\":\"Premium Üyelik\",\"customerId\":\"CUST-789\"}"
}

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

json
{
    "state": 1,
    "result": {
        "recurringId": "34006b2b-f637-468f-812d-250b2d83f766",
        "orderId": "ORDER-2025-001234",
        "processId": "318417eb-9632-4bee-84c2-7fbb2e12609f",
        "authCode": "642130",
        "rrn": "534317010263",
        "cardMask": "54000100mmtkjk04",
        "resultCode": "",
        "procReturnCode": "00",
        "resultMessage": "Onaylandı. ",
        "token": null,
        "htmlContent": null
    }
}