Ortamlar

Base URL’ler

Ortam	API Base URL
Canlı (prod)	`https://gateway.paytalya.com`
Test	onboarding’de verilir

API öneki

Tüm uç noktalar /v1 öneki ile sürümlenir. Örnek tam adres:

https://gateway.paytalya.com/v1/payments

API yüzeyi (gateway.paytalya.com) sunucudan-sunucuya çağrılar içindir (API anahtarı ile). Alıcının tarayıcısının/WebView’inin konuştuğu handoff sayfası ayrı bir origindir (pay.*) ve aşağıda açıklanır.

Handoff sayfası ve dönüş

Kartı kendi checkout’unuzda toplar, ardından alıcıyı Paytalya’nın ayrı handoff sayfasına yönlendirirsiniz. POST /v1/payments isteğinin gövdesi kart içermez ve yanıtında bir handoffUrl döner: bu, alıcının tarayıcısını/WebView’ini kart + paymentRef ile yönlendireceğiniz handoff sayfası adresidir (pay.* origin). handoffUrl’i yanıttan olduğu gibi kullanın; sabit bir değer varsaymazsınız. Banka 3D Secure devri bu sayfada yürür.

3D tamamlandıktan sonra handoff sayfası alıcının tarayıcısını/WebView’ini, POST /v1/payments isteğinde verdiğiniz returnUrl’ine 303 ile yönlendirir. returnUrl üzerinden taşınan sonuç bilgisi, istemci (tarayıcı) üzerinden geldiği için nihai/güvenilir sonuç olarak kabul edilmemelidir; kesin sonucu daima GET /v1/payments ve webhook ile alırsınız.

Web ve mobil arasında Paytalya tarafında fark yoktur (web: native tarayıcı 303; mobil: WebView aynı 303’e iner); mobilde deep-link kullanılmaz. Detay: Kart Handoff.

Ödemenin 3D’yi tamamlamak için geçerli süresi 30 dakikadır; bu süre içinde tamamlanmazsa ödeme expired durumuna geçer.

Sonraki adım

Hızlı Başlangıç: ilk ödemenizi oluşturun