API

Hazır ödeme sayfası

Kart bilgisi sunucunuza hiç uğramadan tahsilat: bir oturum oluşturun, müşteriyi yönlendirin. Kart girişi, taksit seçimi ve 3D Secure yönlendirmesi bizim sayfamızda yürür.

Akış

Sunucunuz POST /v1/checkout/sessions ile oturum oluşturur; yanıttaki url alanını alır.
Müşteriyi bu adrese yönlendirirsiniz (https://pay.paymentgateway.com.tr/c/…).
Müşteri kartını girer. Sayfa, kartın BIN'ine göre kullanılabilir taksit seçeneklerini ve toplam tutarı canlı gösterir; 3D Secure gerekiyorsa bankaya yönlendirir.
İşlem bitince müşteri returnUrl'e döner. Sonucu webhook veya GET /v1/payments/{id} ile doğrulayın.

POST/v1/checkout/sessions

curl https://api.paymentgateway.com.tr/v1/checkout/sessions \
  -H "Authorization: Bearer pgw_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000,
    "currency": "TRY",
    "merchantOrderId": "1002",
    "description": "Siparis #1002",
    "customer": { "email": "ali@example.com", "name": "Ali Veli" },
    "returnUrl": "https://magaza.example/odeme/sonuc",
    "maxInstallment": 6,
    "expiresInMinutes": 60
  }'

201 Created

{
  "id": "chk_01J...",
  "mode": "test",
  "amount": 25000,
  "currency": "TRY",
  "status": "open",
  "maxInstallment": 6,
  "expiresAt": "2026-03-02T10:14:22Z",
  "url": "https://pay.paymentgateway.com.tr/c/Zk3n..."
}

Alan	Açıklama
`amount`	Kuruş cinsinden tutar (zorunlu).
`currency`	TRY (varsayılan), USD, EUR, GBP.
`maxInstallment`	Sayfada sunulacak en yüksek taksit (1–12, varsayılan 12). Gerçek seçenekler ayrıca POS komisyon tablolarına göre daralır.
`expiresInMinutes`	Oturum ömrü: 5 dakika – 7 gün (varsayılan 60).
`returnUrl`	Sonuç sonrası yönlendirme (https).
`merchantOrderId, description, customer, metadata`	Ödemeye taşınır.

Neden hazır sayfa?

Kart verisi yalnızca bizim alan adımızda ve sıkı bir içerik güvenlik politikasıyla (nonce'lı CSP) işlenir; sizin sistemlerinize ulaşmaz. Bu, PCI DSS kapsamınızı önemli ölçüde küçültür.

Oturum durumu

GET/v1/checkout/sessions/{id}

Oturum open, ödeme tamamlanınca bağlandığı payment_id ile kapanır; süresi dolan oturumlar ödeme kabul etmez.

← Öncekiİşlemler Sonraki →Webhook'lar