Düzenli Ödeme

Postman Collection'ını indirmek için tıklayınız. Postman Code Snippet'inde kendi kullandığınız dilin kodlarını görebilirsiniz.

Talimat Oluşturma Metotu #

Düzenli ödeme talimatı oluşturur.

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/api/RecurringPaymentCreate

Body application/json

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`language` opsiyonel		Dil seçeneği. Boş bırakılırsa Türkçe.
	`Instalment` zorunlu		Ödemenin kaç defa alınacağı (max 12).
	`InstalmentPeriod` zorunlu		30'dan farklı değer olamaz.
	`CustomerName` zorunlu		Müşteri adı.
	`CustomerMiddleName` opsiyonel		Müşteri ikinci adı.
	`CustomerSurname` zorunlu		Müşteri soyadı.
	`ClientRefCode` zorunlu		Kendi referans numaranız.
	`PaymentStartChose` zorunlu		Hemen ödeme için 1, ileri tarihli ödeme için 2 gönderilmelidir.
	`PaymentStartDate` zorunlu		PaymentStartChose 2 ise ileri tarihli bir gün, 1 ise mevcut günün tarihi (DD/MM/YYYY).
	`Email` zorunlu		Müşteri e-posta adresi.
	`Gsm` zorunlu		Müşteri cep telefonu.
	`Amount` zorunlu		Her bir ödeme tutarı.
	`Description` opsiyonel		İşleme ait açıklama.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| Gsm \| Amount \| ClientRefCode \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`cardHolderIP` zorunlu		Kart sahibinin IP adresi (IPv4 veya IPv6).

{
  "LINK": "https:\/\/apptest.paynkolay.com.tr\/recurring\/payment?q=eyJhb...",
  "INSTRUCTION_NUMBER": "ACPL00395013",
  "RESPONSE_CODE": 2,
  "ERROR_CODE": null,
  "RESPONSE_DATA": "İşlem Başarılı.",
  "sessionId": "30833435-7b85-440b-b34a-a8056fe53048",
  "CORE_TRX_ID_RESERVED": "0D047D59-795D-43BE-A130-F5F95DF436E9",
  "ERROR_MESSAGE": null,
  "TimeStamp": null
}

Talimat İptal Metotu #

Düzenli ödeme talimatını iptal eder.

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/api/RecurringPaymentCancel

Body application/json

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`InstructionNumber` zorunlu		İptal edilecek talimat numarası.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| InstructionNumber \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`cardHolderIP` zorunlu		Kart sahibinin IP adresi (IPv4 veya IPv6).

{
  "CANCEL_INSTRUCTION": [
    {
      "N_Kolay_Talimat_No": "ACPL00395012",
      "Kalan_Odeme_Sayisi": "2",
      "Tahsil_Edilmis_Odeme_Sayisi": "0"
    }
  ],
  "RESPONSE_CODE": 2,
  "ERROR_CODE": "CORE0302",
  "RESPONSE_DATA": "İşlem Başarılı.",
  "sessionId": "30833435-7b85-440b-b34a-a8056fe53048",
  "CORE_TRX_ID_RESERVED": "CBF4C6A9-AA53-4596-9B6E-65607964ABD0",
  "ERROR_MESSAGE": "İşlem Başarılı.",
  "TimeStamp": null
}

Talimat Listeleme Metotu #

Düzenli ödeme talimatlarını detaylarıyla birlikte listeler.

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/api/RecurringPaymentList

Body application/json

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`startDate` zorunlu		Başlangıç tarihi (DD.MM.YYYY).
	`endDate` zorunlu		Bitiş tarihi (DD.MM.YYYY).
	`nameSurname` opsiyonel		Müşteri ad-soyadına göre filtreleme.
	`gsm` opsiyonel		Müşteri cep telefonuna göre filtreleme.
	`cardHolderIP` zorunlu		Kart sahibinin IP adresi (IPv4 veya IPv6).

{
  "INSTRUCTION_LIST": [
    {
      "ACTIVE": "Pasif",
      "END_PAYMENT_DATE": "27.09.2024",
      "CLIENT_REF_CODE": "APITEST001",
      "TOTAL_PAYMENT_COUNT": "3",
      "MERCHANT_NAME": "123456 - BILGE UAT",
      "TRANSACTION_AMOUNT": "300.00",
      "NEXT_PAYMENT_DATE": "29.07.2024",
      "TRX_DATE": "29.07.2024",
      "INSTRUCTION_STATUS": "Red",
      "PERIOD": "Aylık",
      "NAME_SURNAME": "Bilge Demir",
      "INSTRUCTION_ID": "ACLD00347700",
      "SUCCESSFUL_PAYMENT": "0",
      "TOTAL_AMOUNT": "900.00",
      "GSM": "05555555555"
    },
    {
      "ACTIVE": "Aktif",
      "END_PAYMENT_DATE": "22.08.2024",
      "CLIENT_REF_CODE": " APITEST001",
      "TOTAL_PAYMENT_COUNT": "2",
      "MERCHANT_NAME": "123456 - BILGE UAT",
      "TRANSACTION_AMOUNT": "200.00",
      "NEXT_PAYMENT_DATE": "",
      "TRX_DATE": "29.07.2024",
      "INSTRUCTION_STATUS": "Kapandı",
      "PERIOD": "Aylık",
      "NAME_SURNAME": " Bilge Demir ",
      "INSTRUCTION_ID": "ACLD00347630",
      "SUCCESSFUL_PAYMENT": "1",
      "TOTAL_AMOUNT": "400.00",
      "GSM": "05555555555"
    }
  ],
  "TOTAL_COUNT": 1,
  "RESPONSE_CODE": 2,
  "ERROR_CODE": null,
  "RESPONSE_DATA": "İşlem Başarılı.",
  "sessionId": "30833435-7b85-440b-b34a-a8056fe53048",
  "CORE_TRX_ID_RESERVED": "EE6E1663-A0A0-4DA8-95C0-318813F17085",
  "ERROR_MESSAGE": null,
  "TimeStamp": null
}

Hash methodu için tıklayınız.