API Dokümanı
2 Çeşit Pay N Kolay API'si bulunmaktadır. Bu API'ler ile kendi ödeme form yapınızı oluşturabilirsiniz.
API'ler ile üye işyeri kendi ödeme formunu kullanır.
Minimum TLS 1.2 kullanılmalıdır. TLS Bağlantı Sorunlarını Çözme Kılavuzu için tıklayınız.
1 - Pay N Kolay API ( Taksitleri kendi taksit tablolarınızdan getirmek isterseniz kullanacağınız versiyon )
- Bu versiyonda tüm değişkenler "https://paynkolaytest.nkolayislem.com.tr/Vpos/v1/Payment" adresine Body'de form-data olarak POST edilir. ( sx, clientRefCode, successUrl, failUrl, amount, installmentNo, cardHolderName, month, year, cvv, cardNumber, use3D, transactionType, rnd, hashData, environment, currencyNumber )
- Canlı ortam linki: https://paynkolay.nkolayislem.com.tr/Vpos/v1/Payment
- Hash hesaplaması için tıklayınız.
- Payment Servis linki: "https://paynkolaytest.nkolayislem.com.tr/Vpos/v1/Payment" İlgili tüm değişkenleri Postman collection'ından görebilirsiniz.
- İşlem, 3D değilse ödeme alınır ve successURL sayfanıza response parametreleri dönülür. Response Dönüş Parametreleri
- use3D "true" ise 3D formu gelecektir. Bu formu şu şekilde ekranda çalıştırabilirsiniz.
echo "<div style:display:none>". $obj->BANK_REQUEST_MESSAGE . "</div>";
- Gelen 3D form ekrana basıldığında ilgili bankanın 3D secure penceresi açılır ve burada 3D secure şifresi girilmesi beklenir.
Bu API'nin kullanımında önce taksitler çağırılır. Taksitleri çağırmak için
sx, amount, cardNumber, hosturl, iscardvalid değişkenleri
"https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PaymentInstallments" adresine
Body'de form-data olarak POST edilir.
Sadece BIN numarası ile (kartın ilk 8 hanesi ile) taksit sorgulamak için
iscardvalid parametresi "false" olarak gönderilmeli, ya da hiç gönderilmemelidir.
Hash hesaplaması için tıklayınız.
PaymentInstallments servisinden gelen EncodedValue tutar bilgisi (AUTHORIZATION_AMOUNT)
ve taksit bilgisi (INSTALLMENT) diğer değişkenlerle birlikte Payment Servis'ine
Body'de form-data olarak POST edilir. (EncodedValue, installmentNo, amount, sx,
clientRefCode, successUrl, failUrl, amount, installmentNo, cardHolderName, month, year, cvv,
cardNumber, EncodedValue, use3D, transactionType, hosturl, rnd, hashData, environment).
- Payment Servis linki: "https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/Payment" İlgili tüm değişkenleri Postman collection'ından görebilirsiniz.
- İşlem 3D değilse bu aşamada ödeme alınır. İşlem sonlanır. Response Dönüş Parametreleri
Payment servisine POST edildiğinde, 3D true ise 3D formu gelecektir. Bu formu şu şekilde ekranda çalıştırabilirsiniz:
echo "<div style='display:none'>" . $obj->BANK_REQUEST_MESSAGE . "</div>";
- Gelen 3D formu ekrana basıldığında ilgili bankanın 3D secure penceresi açılır ve burada 3D secure şifresi girilmesi beklenir.