API (3D · NON3D)

Kart bilgilerini kendi arayüzünüzde toplar, ödemeyi RESTful API ile başlatırsınız. Tek uç nokta vardır; akışı use3D parametresi belirler.

Nasıl Çalışır?

Uç Nokta POST /Vpos/v1/Payment

Gövde form-data — alanlar her iki akışta da aynıdır, yalnızca use3D değişir.

İki Akış

Non-3DS use3D=false

Banka doğrulama adımı yoktur
Tek istekte anında sonuçlanır
Sorumluluk üye işyerindedir

3DS use3D=true

Müşteri banka doğrulamasından geçer
Sonuç successUrl / failUrl adresinize POST edilir
Tek ya da 2 aşamalı tamamlanabilir

Non-3DS 3DS

API Sürümleri: v1 · v0

Dokümandaki tüm örnekler v1 içindir. Taksit seçeneklerini kendi arayüzünüzde yönetmek yerine Paynkolay'dan sorgulamak isterseniz v0 akışı kullanılır:

v1 — Taksit Bilgisi Size Ait

Tek uç: /Vpos/v1/Payment
Taksit sayısını installmentNo ile siz gönderirsiniz
Önerilen ve bu dokümanda anlatılan sürüm

v0 — Taksit Bilgisi Paynkolay'a Ait

İki uç: /Vpos/Payment/PaymentInstallments + /Vpos/Payment/Payment
Önce taksit/banka listesi sorgulanır, seçilen EncodedValue ile ödenir
Kart yerine yalnızca BIN ile sorgu: iscardvalid=false

v0 akışı: PaymentInstallments'a kart numarası (ya da BIN) ve tutar gönderilir; dönen PAYMENT_BANK_LIST içinden seçilen taksitin EncodedValue ve INSTALLMENT değerleri, diğer ödeme alanlarıyla birlikte Payment servisine POST edilir. Hash formülü v1 ile aynıdır. Güncel taksit oranları için ayrıca Taksit Servisi'ne bakın.

Bu sayfa yardımcı oldu mu?

Son güncelleme: 10 Eylül 2026