Form ile Ödeme
Zorunlu alanları hash'leyip Paynkolay ortak ödeme sayfasına POST edersiniz; kart bilgileri Paynkolay tarafında alınır, sonuç adresinize imzalı olarak döner.
Genel Bakış
Form ile Ödeme, çevrimiçi işletmelerin ödeme kabul etmesinin en hızlı ve en güvenli yoludur. Müşteri kart bilgilerini sizin sisteminizde değil, Paynkolay'ın mobil uyumlu ortak ödeme sayfasında girer — böylece PCI DSS yükümlülükleri Paynkolay tarafından karşılanır ve entegrasyon birkaç alanlık bir form göndermeye indirgenir.
Avantajlar
Ödeme Akışı
Müşteriniz ödemesini ister tek çekim ister taksitli yapsın, akış dört adımda tamamlanır:
1Müşteri sitenizde "Öde"ye basar; formunuz alanları hash'leyip Paynkolay'a POST eder.
2Ortak ödeme sayfası açılır; müşteri kart bilgilerini girer, taksit seçeneklerini görür.
3Gerekliyse 3D Secure doğrulaması yapılır (SMS / banka şifresi).
4İmzalı sonuç successUrl / failUrl adresinize POST edilir; hash'i doğrulayıp siparişi sonuçlandırırsınız.
Kullanım Seçenekleri
- Müşteri ortak ödeme sayfasına yönlendirilir
- En yaygın ve en basit kullanım
- Ortak ödeme sayfası kendi sitenizin içinde açılır
- Müşteri sitenizden hiç ayrılmaz
Örnek Form
<!-- Müşteri "Öde"ye bastığında bu form ortak ödeme sayfasına gönderilir -->
<form method="POST" action="https://paynkolaytest.nkolayislem.com.tr/Vpos">
<input name="sx" value="118591467|W8a1JLU8A5Cw…FbOO5A==">
<input name="clientRefCode" value="SIP-2026-000123">
<input name="amount" value="249.90">
<input name="successUrl" value="https://magaza.com/odeme/basarili">
<input name="failUrl" value="https://magaza.com/odeme/hata">
<input name="use3D" value="true">
<input name="transactionType" value="sales">
<input name="rnd" value="03-09-2026 15:04:22">
<input name="hashData" value="lunnRyNfDu6pdpNjjlFrlATE…">
</form>hashData, API ile aynı formülle sunucu tarafında üretilir: sx|clientRefCode|amount|successUrl|failUrl|rnd|customerKey|merchantSecretKey → SHA-512 → Base64.
Parametreler
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| sx | string | ✅ | Size verilen satış (sx) değeriniz |
| clientRefCode | string | ✅ | Sizin ürettiğiniz tekil referans numarası |
| amount | decimal | ✅ | Tutar — kuruş ayıracı nokta (ör. 249.90) |
| successUrl | string | ✅ | Başarılı sonucun POST edileceği SSL'li adres |
| failUrl | string | ✅ | Başarısız sonucun POST edileceği SSL'li adres |
| use3D | boolean | ✅ | Ortak ödeme sayfasında 3D akışını belirler |
| transactionType | string | ✅ | sales gönderilmelidir |
| rnd | string | ✅ | İşlem zamanı — ör. 03-09-2026 15:04:22 |
| hashData | string | ✅ | SHA-512 + Base64 istek imzası |
| instalments | string | — | Sunulacak taksit seçenekleri (ör. 1,2,3,6) |
| language | string | — | Ortak ödeme sayfası dili (tr / en) |
| customerKey | string | — | Kart saklanacaksa müşteri anahtarı |
Son güncelleme: 3 Eylül 2026