Ödeme Linki Yolla

Ödeme Linki Yollama uygulaması ile ödeme linki oluşturup e-mail, SMS atabilirsiniz. API ile üye işyeri, kendi ödeme linkini oluşturup e-mail, SMS ile ödeme linkini gönderebilir ve ödeme alabilir.

LINK_AMOUNT_FIXING_TYPE değeri NOT_FIXED olarak set edilirse tutar kontrolü yapılmaz ve değeri müşteri girebilir. Ödeme formunda resim de gözüksün isteniyorsa, IMAGE_URL parametresi ile base64 encode edilmiş şekilde resim kodu gönderilebilir.

CALLBACK_URL gönderilmesi durumunda işlem sonucu ilgili URL'e POST edilir. SEND_SMS ve SEND_EMAIL alanlarından en az biri true olmalıdır.

Ürün/Hizmet Nevi #

Her link için ödemenin hangi ürün/hizmet nevine ait olduğu bildirilmelidir. Bunun için üç alan zorunludur:

Parametre	Açıklama
`PRODUCT_TYPE`	Nevi: `DELIVERY`, `NEW_SALE`, `DEBT` veya `GUARANTEE`. Büyük harfle, birebir gönderilmelidir.
`PRODUCT_TYPE_VALUE`	Neviye göre değişen değer: tarih neviler için `YYYY-AA-GG` formatında tarih, listeli neviler için liste kodu. Detaylar aşağıdaki başlıklardadır.
`PRODUCT_NAME`	Ödemesi alınan ürün/hizmetin adı. En fazla 200 karakter.

Teslim Edilen Ürün/Hizmet Tahsilatı (DELIVERY) #

Müşteriye teslim edilmiş bir ürün veya tamamlanmış bir hizmetin ödemesini almak için kullanılır. Örneğin kargosu teslim edilmiş bir sipariş, yapılmış bir tamir veya verilmiş bir danışmanlık hizmeti.

PRODUCT_TYPE_VALUE: ürünün/hizmetin teslim tarihi, YYYY-AA-GG formatında. Tarih bugün veya geçmiş bir tarih olmalıdır; ileri tarihli teslimat için NEW_SALE kullanınız.

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/pay-by-link-create

Body multipart/form-data

	Parametre	Değer	Açıklama
	`TOKEN` zorunlu		Sx değeriniz.
	`FULL_NAME` zorunlu		Müşterinin adı soyadı. (En fazla 100 karakter.)
	`EMAIL` zorunlu		Müşterinin e-posta adresi.
	`GSM` zorunlu		Müşterinin cep telefonu.
	`LINK_AMOUNT_FIXING_TYPE` zorunlu		"FIXED" veya "NOT_FIXED". "NOT_FIXED" ise tutarı müşteri girer.
	`AMOUNT` zorunlu		İşlem tutarı.
	`LINK_EXPIRATION_TIME` zorunlu		Linkin son kullanım tarihi (YYYY-AA-GG).
	`IS_3D_MUST` zorunlu		3D Secure kullanılacaksa "true".
	`PAYMENT_SUBJECT` zorunlu		Ödemenin başlığı.
	`PRODUCT_TYPE` zorunlu		Ürün/hizmet nevi.
	`PRODUCT_TYPE_VALUE` zorunlu		Teslim tarihi (YYYY-AA-GG). Bugün veya geçmiş bir tarih.
	`PRODUCT_NAME` zorunlu		Ürün/hizmet adı. (En fazla 200 karakter.)
	`EXPLANATION` opsiyonel		Açıklama.
	`CALLBACK_URL` opsiyonel		İşlem sonucunun POST edileceği URL.
	`IMAGE_URL` opsiyonel		Ödeme formunda gösterilecek resim (base64).
	`SEND_SMS` zorunlu		SMS gönderilsin mi? "true" / "false".
	`SEND_EMAIL` zorunlu		E-posta gönderilsin mi? "true" / "false".
	`CLIENT_REFERENCE_CODE` zorunlu		Müşteri referans numaranız.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `TOKEN \| FULL_NAME \| EMAIL \| GSM \| AMOUNT \| LINK_EXPIRATION_TIME \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`INSTALLMENT` opsiyonel		Maksimum taksit sayısı.
	`cardHolderIP` opsiyonel		Müşterinizin IP adresi (IPv4 veya IPv6).

Yeni Ürün/Hizmet Satışı Tahsilatı (NEW_SALE) #

Henüz teslim edilmemiş bir ürün veya ileride verilecek bir hizmetin ödemesini peşin almak için kullanılır. Örneğin yeni bir sipariş, ön satış veya ileri tarihli bir hizmet.

PRODUCT_TYPE_VALUE: beklenen teslimat tarihi, YYYY-AA-GG formatında. Tarih bugün veya ileri bir tarih olmalıdır.

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/pay-by-link-create

Body multipart/form-data

	Parametre	Değer	Açıklama
	`TOKEN` zorunlu		Sx değeriniz.
	`FULL_NAME` zorunlu		Müşterinin adı soyadı. (En fazla 100 karakter.)
	`EMAIL` zorunlu		Müşterinin e-posta adresi.
	`GSM` zorunlu		Müşterinin cep telefonu.
	`LINK_AMOUNT_FIXING_TYPE` zorunlu		"FIXED" veya "NOT_FIXED". "NOT_FIXED" ise tutarı müşteri girer.
	`AMOUNT` zorunlu		İşlem tutarı.
	`LINK_EXPIRATION_TIME` zorunlu		Linkin son kullanım tarihi (YYYY-AA-GG).
	`IS_3D_MUST` zorunlu		3D Secure kullanılacaksa "true".
	`PAYMENT_SUBJECT` zorunlu		Ödemenin başlığı.
	`PRODUCT_TYPE` zorunlu		Ürün/hizmet nevi.
	`PRODUCT_TYPE_VALUE` zorunlu		Beklenen teslimat tarihi (YYYY-AA-GG). Bugün veya ileri bir tarih.
	`PRODUCT_NAME` zorunlu		Ürün/hizmet adı. (En fazla 200 karakter.)
	`EXPLANATION` opsiyonel		Açıklama.
	`CALLBACK_URL` opsiyonel		İşlem sonucunun POST edileceği URL.
	`IMAGE_URL` opsiyonel		Ödeme formunda gösterilecek resim (base64).
	`SEND_SMS` zorunlu		SMS gönderilsin mi? "true" / "false".
	`SEND_EMAIL` zorunlu		E-posta gönderilsin mi? "true" / "false".
	`CLIENT_REFERENCE_CODE` zorunlu		Müşteri referans numaranız.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `TOKEN \| FULL_NAME \| EMAIL \| GSM \| AMOUNT \| LINK_EXPIRATION_TIME \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`INSTALLMENT` opsiyonel		Maksimum taksit sayısı.
	`cardHolderIP` opsiyonel		Müşterinizin IP adresi (IPv4 veya IPv6).

Eski Tarihli Borç Tahsilatı (DEBT) #

Daha önceden doğmuş bir borcun tahsilatı için kullanılır. Örneğin ödenmemiş bir fatura, senet, yapılandırılmış bir borç taksiti veya mahkeme kararına bağlı bir ödeme.

PRODUCT_TYPE_VALUE: borcun dayanağını belirten kod. Yalnızca aşağıdaki kodlardan biri gönderilebilir (metin değil, kod gönderilmelidir):

Kod	Açıklama
`1`	Vadesi Geçmiş Fatura
`2`	Düzenlenmiş Borç Senedi
`3`	Yapılandırma Sözleşmesi / Protokol
`4`	İcra / Mahkeme Ödeme Kararı

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/pay-by-link-create

Body multipart/form-data

	Parametre	Değer	Açıklama
	`TOKEN` zorunlu		Sx değeriniz.
	`FULL_NAME` zorunlu		Müşterinin adı soyadı. (En fazla 100 karakter.)
	`EMAIL` zorunlu		Müşterinin e-posta adresi.
	`GSM` zorunlu		Müşterinin cep telefonu.
	`LINK_AMOUNT_FIXING_TYPE` zorunlu		"FIXED" veya "NOT_FIXED". "NOT_FIXED" ise tutarı müşteri girer.
	`AMOUNT` zorunlu		İşlem tutarı.
	`LINK_EXPIRATION_TIME` zorunlu		Linkin son kullanım tarihi (YYYY-AA-GG).
	`IS_3D_MUST` zorunlu		3D Secure kullanılacaksa "true".
	`PAYMENT_SUBJECT` zorunlu		Ödemenin başlığı.
	`PRODUCT_TYPE` zorunlu		Ürün/hizmet nevi.
	`PRODUCT_TYPE_VALUE` zorunlu		Borç dayanağı kodu: `1`, `2`, `3` veya `4`.
	`PRODUCT_NAME` zorunlu		Ürün/hizmet adı. (En fazla 200 karakter.)
	`EXPLANATION` opsiyonel		Açıklama.
	`CALLBACK_URL` opsiyonel		İşlem sonucunun POST edileceği URL.
	`IMAGE_URL` opsiyonel		Ödeme formunda gösterilecek resim (base64).
	`SEND_SMS` zorunlu		SMS gönderilsin mi? "true" / "false".
	`SEND_EMAIL` zorunlu		E-posta gönderilsin mi? "true" / "false".
	`CLIENT_REFERENCE_CODE` zorunlu		Müşteri referans numaranız.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `TOKEN \| FULL_NAME \| EMAIL \| GSM \| AMOUNT \| LINK_EXPIRATION_TIME \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`INSTALLMENT` opsiyonel		Maksimum taksit sayısı.
	`cardHolderIP` opsiyonel		Müşterinizin IP adresi (IPv4 veya IPv6).

Güvence Bedeli / Depozito Tahsilatı (GUARANTEE) #

Bir hizmet veya rezervasyonu güvence altına almak için alınan depozito, kaparo ve benzeri ödemeler için kullanılır. Örneğin kira depozitosu, etkinlik ön ödemesi veya rezervasyon garanti bedeli.

PRODUCT_TYPE_VALUE: güvence bedelinin türünü belirten kod. Yalnızca aşağıdaki kodlardan biri gönderilebilir (metin değil, kod gönderilmelidir):

Kod	Açıklama
`5`	Kira / Hizmet Depozitosu
`6`	Etkinlik / Organizasyon Ön Ödemesi
`7`	Randevu / Rezervasyon Garanti Bedeli
`8`	Ön Sipariş Kaparo Bedeli
`9`	Site Aidatı

POST https://paynkolaytest.nkolayislem.com.tr/Vpos/pay-by-link-create

Body multipart/form-data

	Parametre	Değer	Açıklama
	`TOKEN` zorunlu		Sx değeriniz.
	`FULL_NAME` zorunlu		Müşterinin adı soyadı. (En fazla 100 karakter.)
	`EMAIL` zorunlu		Müşterinin e-posta adresi.
	`GSM` zorunlu		Müşterinin cep telefonu.
	`LINK_AMOUNT_FIXING_TYPE` zorunlu		"FIXED" veya "NOT_FIXED". "NOT_FIXED" ise tutarı müşteri girer.
	`AMOUNT` zorunlu		İşlem tutarı.
	`LINK_EXPIRATION_TIME` zorunlu		Linkin son kullanım tarihi (YYYY-AA-GG).
	`IS_3D_MUST` zorunlu		3D Secure kullanılacaksa "true".
	`PAYMENT_SUBJECT` zorunlu		Ödemenin başlığı.
	`PRODUCT_TYPE` zorunlu		Ürün/hizmet nevi.
	`PRODUCT_TYPE_VALUE` zorunlu		Güvence bedeli kodu: `5`, `6`, `7`, `8` veya `9`.
	`PRODUCT_NAME` zorunlu		Ürün/hizmet adı. (En fazla 200 karakter.)
	`EXPLANATION` opsiyonel		Açıklama.
	`CALLBACK_URL` opsiyonel		İşlem sonucunun POST edileceği URL.
	`IMAGE_URL` opsiyonel		Ödeme formunda gösterilecek resim (base64).
	`SEND_SMS` zorunlu		SMS gönderilsin mi? "true" / "false".
	`SEND_EMAIL` zorunlu		E-posta gönderilsin mi? "true" / "false".
	`CLIENT_REFERENCE_CODE` zorunlu		Müşteri referans numaranız.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `TOKEN \| FULL_NAME \| EMAIL \| GSM \| AMOUNT \| LINK_EXPIRATION_TIME \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`INSTALLMENT` opsiyonel		Maksimum taksit sayısı.
	`cardHolderIP` opsiyonel		Müşterinizin IP adresi (IPv4 veya IPv6).

Hata Mesajları #

Nevi alanlarındaki hatalarda RESPONSE_CODE 0 döner ve sebep RESPONSE_DATA alanında yer alır:

Durum	RESPONSE_DATA
`PRODUCT_TYPE` eksik veya geçersiz	`PRODUCT_TYPE degeri DELIVERY,NEW_SALE,DEBT ,GUARANTEE veya DONATION degeri alabilir.`
`PRODUCT_TYPE_VALUE` eksik	`PRODUCT_TYPE_VALUE Boş gecilemez`
`PRODUCT_NAME` eksik	`PRODUCT_NAME Boş gecilemez`
Tarih formatı hatalı	`E090 : 0 - Teslimat tarihi formatı dd.MM.yyyy şeklinde olmalıdır.`
`DELIVERY` için ileri tarih	`E090 : 0 - Teslimat tarihi bugünden ileri bir tarih olamaz.`
`NEW_SALE` için geçmiş tarih	`E090 : 0 - Beklenen teslimat tarihi bugünden ileri bir tarih olmalıdır.`
Listede olmayan kod	`Ürün Nev Degeri PRODUCT_TYPE_VALUE DEBT, için 1,2,3,4 degerlerinden birini alabilir.`

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

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