DOCS
Panel Giriş Başvurun

PAYNKOLAY DOCS

Entegrasyon Dokümantasyonu

Test ortamından canlı yayına giden her adım: size uygun tahsilat metodunu seçin, sandbox'ta deneyin, aynı gün ödeme almaya başlayın. API referansı, örnek kodlar ve hazır eklentiler bu dokümantasyonda.

Hemen Başlayın
5200 19•• •••• 1495 SKT 2030/01 · CVC 462 · TEST KARTI
ENTEGRASYON YOLCULUĞU

Altı adımda canlıya

Hangi tahsilat metodunu seçerseniz seçin yol aynıdır — altı durak, tek hedef: canlıda ödeme.

  1. BaşvuruÜye işyeri hesabınız açılır, panel erişiminiz gelir.
  2. Test BilgileriDokümandaki hazır test sx ve Secret Key ile başlayın.
  3. Yöntem SeçimiForm, link, API veya hazır eklenti.
  4. Entegrasyon & Hashİstek hash'ini üretin, yanıt hash'ini ve işlem sonucunu doğrulayın.
  5. Test İşlemiTest kartlarıyla uçtan uca ödeme deneyin.
  6. Canlıya GeçişCanlı bilgilerinizi panelden alın, yayına çıkın.
DOKÜMAN BÖLÜMLERİ

Dokuz bölümde tüm sistem

Ana başlıklar ve tüm alt başlıklar — bir bölüme ya da doğrudan bir alt sayfaya geçin.

BÖLÜM 01Ön HazırlıkTest ortamı, panel erişimi, kontrol listesi ve test kartları.
BÖLÜM 02Tahsilat MetoduAPI (3D · NON3D), form, linkli ödeme, ön provizyon, düzenli ödeme.
BÖLÜM 03ÜrünlerSanal POS'tan Açık Bankacılığa 12 ürünlük aile.
BÖLÜM 04Ek ServislerKart saklama, iptal & iade, ödeme sonucu, raporlama.
BÖLÜM 05MasterpassCVV'siz işlem yetkisi, Masterpass'e iletilecek bilgiler ve destek kanalları.
BÖLÜM 06Pazaryeri EntegrasyonuAlt satıcılar, ödeme profilleri, komisyon dağıtımı.
BÖLÜM 07Open Source EntegrasyonlarWooCommerce, OpenCart, Magento ve diğer hazır eklentiler.
BÖLÜM 08Ek BilgilerPostman, Hash Aracı, hata ve banka kodları, TLS ve iFrame.
BÖLÜM 09Sıkça Sorulan SorularEn çok merak edilen konular ve çözüm adımları.
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.

TEST https://paynkolaytest.nkolayislem.com.tr/Vpos
CANLI https://paynkolay.nkolayislem.com.tr/Vpos
ÖRNEK İSTEK

Ortak Ödeme (Form) — POST /Vpos

Kart bilgileri Paynkolay ortak ödeme sayfasında alınır; PCI DSS yükü Paynkolay tarafındadır.

PARAMETRETİPZORUNLUAÇIKLAMA
sxstringEVETÜye işyerine özel token; panelinizden alınır, istemcide saklanmaz
amountdecimalEVETÖdeme tutarı — kuruş ayıracı nokta, ör. 102.50
successUrlstringEVETBaşarılı sonucun POST edileceği adres (geçerli SSL zorunlu)
failUrlstringEVETBaşarısız sonucun POST edileceği adres
rndstringEVETHer istekte üretilen tekil değer; hash'e dahildir
hashDatastringEVETAlanların | ile birleşip SHA-512 + Base64 ile imzalanmış hâli
agentCodestringHAYIRAlt temsilcilik üzerinden işlemde temsilci kodu
İSTEK · FORM-DATA 
# 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…
YANIT · 200 
{
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": "İşlem başarıyla tamamlandı",
  "AUTH_CODE": "P57624",
  "REFERENCE_CODE": "100034280",
  "USE_3D": true,
  "HASHDATA": "vLXSb0Y3Swm4tMr…"
}
SSS

Sıkça sorulan sorular

Aradığınızı bulamazsanız destek ekibi bir e-posta uzağınızda.

Canlı sx ve Secret Key değerlerimi nereden alırım?

Panelde Ayarlar → Entegrasyon Bilgileri adımından. Göremiyorsanız üye işyerinizde API yetkisi tanımlı olmayabilir.

Hash uyuşmuyor, ne yapmalıyım?

Alan sırasını ve boş customerKey borusunu kontrol edin; imzanızı Hash Aracı çıktısıyla karşılaştırın.

Web sitem yok — tahsilat yapabilir miyim?

Evet — Linkli Ödeme ile panelden link oluşturup SMS/e-posta ile gönderirsiniz; teknik bilgi gerektirmez.

Daha Fazlası

Takıldığınız adım mı var?

Entegrasyon ekibimiz her adımda yanınızda — genellikle aynı gün dönüş.

kolayposdestek@nkolay.com.tr

Son güncelleme: 11 Eylül 2026

v8 · Versiyonlar