DOCS Panel Giriş Başvurun

Tahsilat Metodu

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

Daha hızlı entegrasyon Kart ekranı, taksit listesi ve 3D akışı hazır — siz yalnızca formu gönderirsiniz.
Güçlü güvenlik güvencesi PCI DSS uyumu Paynkolay'da; 3D Secure ve hash imzası akışın parçasıdır.
Çoklu ödeme seçeneği Visa, Mastercard, Troy, Amex; taksit seçenekleri karta göre otomatik listelenir.

Ödeme Akışı

MüşteriSitenizOrtak Ödeme SayfasıBanka (3D)Ödemeye geç1Form POST(sx · amount · hashDatav2…)2Kart bilgileri Paynkolay sayfasında girilir3SMS / OTP onayı4Sonuç successUrl'e POST5Hash + tutar doğrulaması6Sipariş onayı7

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

Yönlendirme (varsayılan)
  • Müşteri ortak ödeme sayfasına yönlendirilir
  • En yaygın ve en basit kullanım
iframe içinde
  • Ortak ödeme sayfası kendi sitenizin içinde açılır
  • Müşteri sitenizden hiç ayrılmaz

Örnek Form

Örnek Form — HTML
<!-- 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

ParametreTipZorunluAçıklama
sxstringSize verilen satış (sx) değeriniz
clientRefCodestringSizin ürettiğiniz tekil referans numarası
amountdecimalTutar — kuruş ayıracı nokta (ör. 249.90)
successUrlstringBaşarılı sonucun POST edileceği SSL'li adres
failUrlstringBaşarısız sonucun POST edileceği SSL'li adres
use3DbooleanOrtak ödeme sayfasında 3D akışını belirler
transactionTypestringsales gönderilmelidir
rndstringİşlem zamanı — ör. 03-09-2026 15:04:22
hashDatastringSHA-512 + Base64 istek imzası
instalmentsstringSunulacak taksit seçenekleri (ör. 1,2,3,6)
languagestringOrtak ödeme sayfası dili (tr / en)
customerKeystringKart saklanacaksa müşteri anahtarı
Bu Bölümde Tahsilat Metodu

Son güncelleme: 3 Eylül 2026

v7 · Versiyonlar