₺Mağazamhazır Ödeme
Türkiye için ödeme altyapısı

Tek entegrasyon. Tüm Türk bankaları.

Sağlayıcıdan bağımsız kart ödeme ağ geçidi. Her üye işyerini 12 Türk bankasından herhangi birine — İşbank, Akbank, QNB, Garanti BBVA, VakıfBank, Yapı Kredi, Kuveyt Türk, Ziraat, Halkbank, TEB, Şekerbank, Anadolubank — tam olarak aynı API üzerinden yönlendirin. Bankaya özel kod olmadan.

Ücretsiz başlaAPI'yi incele
12 banka
tek ortak API
1 uç nokta kümesi
her banka için aynı
Barındırılan ödeme
sizi PCI kapsamı dışında tutar
3-D Secure
her bankada yerleşik

Tek API, tüm bankalar

Üye işyerinin tanımlı sağlayıcısı, ödemeyi hangi bankanın yürüteceğini belirler. Siz tek bir uç nokta kümesi çağırırsınız; biz arka planda her bankanın protokolüne çeviririz ve iadeleri ile provizyonları doğru bankaya yönlendiririz.

AkbankCanlı doğrulandı
HMAC JSON (apipre.akbank.com — auth-hash: base64(HMAC-SHA512(secret, body)))
Garanti BBVACanlı doğrulandı
GVPS (XML → VPServlet, SHA512 in-body hash)
Albaraka TürkEntegre
POSNET V1 (JSON MerchantJSONAPI.svc, SHA256 MAC)
DenizBankEntegre
InterVPOS (Intertech) — form-POST, SHA1-base64 hash
Kuveyt TürkEntegre
KTPay (JSON /KTPay/*) + legacy XML Home/Non3DPayGate
Vakıf KatılımEntegre
Architecht/BOA (XML → VirtualPOS.Gateway/Home, SHA1 in-body hash)
VakıfBankEntegre
VPOS (XML as `prmstr` form field → Vposreq.aspx)
Alternatif Bank (ABank)Entegre
NestPay/EST (XML CC5Request)
AnadolubankEntegre
NestPay/EST (XML CC5Request)
HalkbankEntegre
NestPay/EST (XML CC5Request)
ING TürkiyeEntegre
NestPay/EST (XML CC5Request)
QNB (Finansbank)Entegre
NestPay/EST (XML CC5Request)
ŞekerbankEntegre
NestPay/EST (XML CC5Request)
TEB (Türk Ekonomi Bankası)Entegre
NestPay/EST (XML CC5Request)
Türkiye FinansEntegre
NestPay/EST (XML CC5Request)
Türkiye İş BankasıEntegre
NestPay/EST (XML CC5Request)
Yapı KrediEntegre
POSNET (XML as `xmldata` form field → PosnetWebService/XML)
Ziraat BankasıEntegre
NestPay/EST (XML CC5Request)
Ziraat KatılımEntegre
PayFor (İnnova/Architecht XML → XMLGate.aspx, SHA1 3D hash)

Yönlendirme nasıl çalışır

Tek istek girer, doğru banka çıkar. Ağ geçidi kartı inceler ve üye işyerinin entegre ettiği en ucuz rayı seçer — otomatik, sunucu tarafında, isteğinizi veya yanıtınızı değiştirmeden.

1 · BIN yönlendirme

Ödeme geldiği anda kartı çıkaran bankayı belirlemek için kartın BIN'ini — baştaki hanelerini — okuruz.

2 · On-us tercihi

Üye işyeri kartın kendi bankasını entegre ettiyse ödeme orada yürür — genellikle en ucuz yol olan bir "on-us" işlemi.

3 · Varsayılan yedek

Aksi halde ödemeyi üye işyerinin varsayılan bankası alır. İstek ve yanıt şekilleriniz asla değişmez.

4 · İmzalı webhook'lar

Her sonuç HMAC ile imzalı, zaman damgalı bir webhook olarak iletilir; böylece sistemleriniz sorgulamaya gerek kalmadan senkron kalır.

Ödeme almanın iki yolu

Önerilen

Barındırılan ödeme

Bir oturum oluşturun ve alışveriş yapanı barındırdığımız güvenli sayfaya yönlendirin. Kart verisi hiçbir zaman sunucularınıza dokunmaz — mümkün olan en küçük PCI kapsamı. Etkinleştirildiğinde 3-D Secure otomatik çalışır.

  1. 1POST /v1/checkout/sessions → { url }
  2. 2Alışveriş yapanı url'ye yönlendirin
  3. 3Onu callback adresinize döndürürüz
Tam kontrol

Doğrudan API

Kart formunu siz yönetin ve ödemeleri doğrudan API'ye gönderin. Sunucudan sunucuya satış, 3-D Secure başlatma, ön provizyon, provizyon kapama, iade ve iptal — hepsi MHPAYv1 ile imzalanır.

  1. 1Kart ile POST /v1/payments
  2. 2Veya /v1/payments/3ds/initialize
  3. 3Webhook ile doğrulayın veya sorgulayın

Kimlik doğrulama — MHPAYv1

Her isteği gizli anahtarınızla imzalayın. Bir Authorization ve bir x-mhpay-timestamp başlığı gönderin; sunucu ±300s pencereyi kontrol eder.

Authorization: MHPAYv1 base64("apiKey:<pk>&randomKey:<rnd>&signature:<hmac>")
x-mhpay-timestamp: <unix seconds>

signature = HMAC-SHA256(secret, timestamp + "." + randomKey + "." + path + "." + rawBody)

Temel uç noktalar

Her banka için aynı — üye işyerinin sağlayıcısı rayı seçer.

POST/api/v1/payments
POST/api/v1/payments/3ds/initialize
POST/api/v1/payments/preauth
POST/api/v1/payments/:id/capture
POST/api/v1/payments/:id/refunds
POST/api/v1/checkout/sessions
GET/api/v1/payments/:id

Sandbox test kartları

4001 7433 0010 0001onaylar
4001 7433 0010 0100reddeder

Hazır olduğunuzda

Dakikalar içinde bir sandbox hesabı oluşturun, anında test anahtarları üretin ve bankalarınız tanımlandığında canlıya geçin. Bankaya özel kod yok — hepsi için tek entegrasyon.

Ücretsiz başlaBize ulaşın