Düzenli Ödeme

Talimat oluşturursunuz; tahsilat, belirlenen dönemlerde müşterinin kayıtlı kartından otomatik alınır.

Genel Bakış

Düzenli Ödeme, aidat ve abonelik modelleri için tasarlanmıştır: bir talimat tanımlarsınız; ödeme, 30 günlük dönemlerle ve en fazla 12 tekrar olacak şekilde otomatik tahsil edilir. Talimat, ilk ödemeyi hemen ya da ileri bir tarihte başlatabilir.

Talimat Oluşturma

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

Gövdeapplication/json

Örnek İstek — JSON

{
  "sx": "118591467|W8a1JLU8A5Cw…FbOO5A==",
  "Instalment": 6,
  "InstalmentPeriod": 30,
  "CustomerName": "Ayşe",
  "CustomerSurname": "Yılmaz",
  "ClientRefCode": "TAL-2026-000042",
  "PaymentStartChose": 1,
  "PaymentStartDate": "03/09/2026",
  "Email": "ayse@mail.com",
  "Gsm": "5553900000",
  "Amount": 149.90,
  "cardHolderIP": "85.100.20.15",
  "hashDatav2": "lunnRyNfDu6pdpNjjlFrlATE…"
}

Parametre	Tip	Zorunlu	Açıklama
sx	string	✅	Size verilen sx değeriniz
Instalment	integer	✅	Ödemenin kaç defa alınacağı (en fazla 12)
InstalmentPeriod	integer	✅	Dönem — 30'dan farklı olamaz
CustomerName / CustomerSurname	string	✅	Müşteri adı ve soyadı (CustomerMiddleName opsiyonel)
ClientRefCode	string	✅	Kendi referans numaranız — benzersiz gönderin
PaymentStartChose	integer	✅	1 = hemen, 2 = ileri tarihli
PaymentStartDate	string	✅	İlk ödeme tarihi (DD/MM/YYYY) — 1 seçildiyse bugünün tarihi
Email / Gsm	string	✅	Müşteri e-posta ve cep telefonu
Amount	decimal	✅	Her bir ödemenin tutarı
hashDatav2	string	✅	İmza — formül: sx\|Gsm\|Amount\|ClientRefCode\|merchantSecretKey
cardHolderIP	string	✅	Müşterinin IP adresi
Description / language	string	—	Açıklama; dil boşsa Türkçe

Talimat İptal

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

Gövdeapplication/json

Parametre	Tip	Zorunlu	Açıklama
sx	string	✅	Size verilen sx değeriniz
InstructionNumber	string	✅	İptal edilecek talimat numarası
hashDatav2	string	✅	İmza — formül: sx\|InstructionNumber\|merchantSecretKey
cardHolderIP	string	✅	Müşterinin IP adresi

Talimat Listeleme

Bu servis sx-list değerini kullanır. Opsiyonel filtrelerle (ad-soyad, GSM ya da talimat numarası) sonuçları daraltabilirsiniz.

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

Gövdeapplication/json

Parametre	Tip	Zorunlu	Açıklama
sx	string	✅	Listeleme (sx-list) değeriniz
startDate	string	✅	Başlangıç tarihi (DD.MM.YYYY)
endDate	string	✅	Bitiş tarihi (DD.MM.YYYY)
nameSurname	string	—	Ad soyad filtresi
gsm	string	—	GSM filtresi
instructionNumber	string	—	Listeleme yanıtındaki INSTRUCTION_ID değeri

Bu sayfa yardımcı oldu mu?

Son güncelleme: 3 Eylül 2026