01 / GENEL BAKIŞ
Entegrasyonun teknik çizimi
Ödeme kabul etmeye başlamak için gereken her şey tek föyde: test bilgileri, tahsilat metodları, API uçları ve hazır eklentiler — adım adım, ölçekli.
02 / ENTEGRASYON HATTI
Beş adımda canlıya
Hangi tahsilat metodunu seçerseniz seçin hat aynıdır. Her adım föyün ilgili bölümüne bağlıdır.
03 / ERİŞİM UÇLARI
Test ve canlı ortam
Tüm istekler application/x-www-form-urlencoded gövdeyle POST edilir. Canlıya geçerken yalnızca taban adres değişir.
https://paynkolaytest.nkolayislem.com.tr/Vpos
https://paynkolay.nkolayislem.com.tr/Vpos
Canlıya geçerken: size özel canlı bilgilerinize (sx, Merchant Secret Key) panelinizden ulaşırsınız. Panelde göremiyorsanız nedeni genellikle üye işyerinizde API yetkisinin tanımlı olmaması ya da ana kullanıcı olmamanızdır.
04 / ÖRNEK İSTEK — ORTAK ÖDEME (FORM)
POST /Vpos parametreleri
Kart bilgileri Paynkolay ortak ödeme sayfasında alınır; PCI DSS yükü Paynkolay tarafındadır.
| PARAMETRE | TİP | ZORUNLU | AÇIKLAMA |
|---|---|---|---|
| sx | string | EVET | Üye işyerine özel token; panelinizden alınır, istemcide saklanmaz |
| amount | decimal | EVET | Ödeme tutarı — kuruş ayıracı nokta, ör. 102.50 |
| successUrl | string | EVET | Başarılı sonucun POST edileceği adres (geçerli SSL zorunlu) |
| failUrl | string | EVET | Başarısız sonucun POST edileceği adres |
| rnd | string | EVET | Her istekte üretilen tekil değer; hash'e dahildir |
| hashData | string | EVET | Alanların | ile birleşip SHA-512 + Base64 ile imzalanmış hâli |
| agentCode | string | HAYIR | Alt temsilcilik üzerinden işlemde temsilci kodu |
# hash: alanlar | ile birleşir, SHA-512 + Base64 (sunucu tarafında)
sx=118591467|W8a1JLU8A5Cw…FbOO5A==
amount=102.50
successUrl=https://magaza.com/odeme/basarili
failUrl=https://magaza.com/odeme/hata
rnd=07-09-2026 14:25:11
hashData=vLXSb0Y3Swm4tMr…{
"RESPONSE_CODE": 2,
"RESPONSE_DATA": "İşlem başarıyla tamamlandı",
"AUTH_CODE": "P57624",
"REFERENCE_CODE": "100034280",
"USE_3D": true,
"HASHDATA": "vLXSb0Y3Swm4tMr…"
}05 / TEST VERİLERİ
Sandbox bilgileri
Gerçek kart bilgisi kullanmadan tüm akışları deneyebilirsiniz. Test kartlarının tam listesi Ön Hazırlık modülündedir.
Secret Key yalnızca sunucu tarafında saklanır; hash üretimi hiçbir zaman tarayıcıda yapılmaz. Formülünüzü doğrulamak için Hash Aracı'nı kullanın.
06 / MODÜLLER
Doküman bölümleri
Föyün tamamı sekiz modüle ayrılır; her modül kendi alt sayfalarına açılır.
07 / SSS
Sıkça sorulan sorular
Test ve canlı ortam adresleri nedir?
Test: paynkolaytest.nkolayislem.com.tr/Vpos · Canlı: paynkolay.nkolayislem.com.tr/Vpos. Gövde yapısı iki ortamda da aynıdır.
Canlı sx ve Secret Key değerlerimi nereden alırım?
Panelde Ayarlar → Entegrasyon Bilgileri adımından. Göremiyorsanız API yetkiniz tanımlı olmayabilir — destek ekibine yazın.
Hash uyuşmuyor, nereden kontrol etmeliyim?
Alan sırasını ve boş customerKey borusunu kontrol edin; ürettiğiniz imzayı Hash Aracı çıktısıyla karşılaştırın.
Son güncelleme: 7 Eylül 2026