Ödeme Linki Oluşturma
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.
Son güncelleme: 3 Eylül 2026