Server ile Güvenli Ödeme
Kendi ödeme linkinizi üretir, dilediğiniz kanaldan paylaşırsınız; ödeme ortak ödeme sayfasında gerçekleşir.
Genel Bakış
Servis, verdiğiniz tutar ve adreslerle tek kullanımlık bir ödeme linki üretir. Link, tıklanmasından bağımsız olarak 10 dakika geçerlidir; başarılı işlem sonrası sonuç successUrl adresinize POST edilir.
Uç Nokta
TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/by-link-create
Gövdemultipart/form-data
Örnek İstek
# POST https://paynkolaytest.nkolayislem.com.tr/Vpos/by-link-create (form-data)
sx=118591467|W8a1JLU8A5Cw…FbOO5A==
clientRefCode=SIP-2026-000124
amount=1000.00
successUrl=https://magaza.com/odeme/basarili
failUrl=https://magaza.com/odeme/hata
rnd=20260903155649
use3D=true
transactionType=SALES currencyCode=949 instalments=8
hashDatav2=lunnRyNfDu6pdpNjjlFrlATE…hashDatav2, API ile aynı formülle üretilir: sx|clientRefCode|amount|successUrl|failUrl|rnd|customerKey|merchantSecretKey → SHA-512 → Base64.
Parametreler
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| sx | string | ✅ | Size verilen sx değeriniz |
| clientRefCode | string | ✅ | Kendi referans numaranız — her işlem için benzersiz gönderin; aksi halde sorgulama/raporlamada işlemler ayırt edilemez |
| amount | decimal | ✅ | İşlem tutarı |
| successUrl | string | ✅ | Başarılı sonucun POST edileceği adres |
| failUrl | string | ✅ | Başarısız sonucun POST edileceği adres |
| rnd | string | ✅ | Timestamp önerilir (ör. 20260903155649) |
| use3D | boolean | ✅ | 3D Secure kullanılacaksa true |
| transactionType | string | ✅ | SALES gönderilmelidir |
| hashDatav2 | string | ✅ | SHA-512 + Base64 istek imzası |
| currencyCode | string | — | TL için 949 |
| instalments | string | — | Sunulacak taksit seçenekleri (ör. 8) |
| detail | boolean | — | true ise müşteri bilgi alanları ödeme sayfasında gösterilir |
| inputNamesurname / inputEmail / inputPhone… | string | — | detail=true iken ön doldurulacak müşteri bilgileri |
| cardHolderIP | string | — | Müşterinin IP adresi (IPv4/IPv6) |
Yanıt
Yanıtta dönen link referansı (q), linki silmek istediğinizde kullanılır.
İstek sunucunuzdan gönderilir; yanıtta ödeme linki ve link referansı (q) döner. Müşteri linkte ödeme yaptığında sonuç successUrl / failUrl adresinize POST edilir; doğrulama kuralları için Ödeme Sonucu sayfasına bakın.
Bu servisin örnek JSON yanıtı yakında eklenecek.
Ödeme Linki Silme
Oluşturulmuş bir ödeme linkini silmek için bu servisi kullanırsınız. q parametresi, link oluşturulurken yanıtta dönen referans numarasıdır.
Silme işlemi geri alınamaz. Hash hesaplaması doğru yapılmazsa işlem başarısız olur.
TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/by-link-url-remove
Gövdemultipart/form-data
curl -X POST "https://paynkolaytest.nkolayislem.com.tr/Vpos/by-link-url-remove" \
-F "sx=118591467|W8a1JLU8A5Cw…FbOO5A==" \
-F "q=by6353337820250825153001" \
-F "hashDatav2=lunnRyNfDu6pdpNjjlFrlATE…"Bu servisin imza formülü: sx|q|merchantSecretKey → SHA-512 → Base64.
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| sx | string | ✅ | Size verilen sx değeriniz |
| q | string | ✅ | Silinecek linkin referans numarası (oluşturma yanıtında döner) |
| hashDatav2 | string | ✅ | SHA-512 + Base64 istek imzası |
| cardHolderIP | string | — | Müşterinin IP adresi (IPv4/IPv6) |
Son güncelleme: 15 Eylül 2026