İçeriğe geç
PaymentGateway
Giriş yapÜcretsiz başla
Başlarken

Hızlı başlangıç

Hesabınızı açın, bir sanal POS bağlayın ve ilk test ödemenizi API ile alın. Tüm süreç birkaç dakika sürer.

1. Hesap ve üye işyeri

Panelden kayıt olun. Kayıt, ayrı bir kimlik sistemi olan SSO üzerinden yapılır; ilk girişte üye işyeriniz (tenant) oluşturulur. Ekibinizi rol vererek davet edebilirsiniz.

2. Sanal POS hesabınızı ekleyin

Panel → Sanal POS'lar → Yeni hesap. Sağlayıcıyı seçin; her sağlayıcı kendi kimlik alanlarını ister (ör. Garanti için terminal ve üye işyeri numaraları, iyzico için apiKey/secretKey). Ortamı test olarak seçip bankanızın size verdiği test bilgilerini girin, ardından Doğrula'ya basın.

Komisyon tablosunu doldurun: borç/kredi kartı ve 1–12 taksit için oranlar. Boş bırakılan hücre, o taksit/kart türünün kapalı olduğu anlamına gelir; yönlendirme motoru bu hesabı o ödeme için aday saymaz.

3. API anahtarı alın

Panel → Geliştirici → API anahtarları. pgw_test_ ile başlayan anahtar yalnızca test ortamındaki POS hesaplarınıza, pgw_live_ ile başlayan anahtar canlı hesaplarınıza yönlenir. Anahtar yalnızca oluşturulduğunda bir kez gösterilir.

4. İlk ödeme

Tutarlar kuruş cinsinden tamsayıdır: 159,90 TL için 15990. Varsayılan olarak ödeme 3D Secure ile başlatılır.

curl https://api.paymentgateway.com.tr/v1/payments \
  -H "Authorization: Bearer pgw_test_xxxxxxxx" \
  -H "Idempotency-Key: siparis-1001" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15990,
    "currency": "TRY",
    "installment": 3,
    "card": {
      "number": "4111111111111111",
      "expMonth": "12",
      "expYear": "2030",
      "cvv": "123",
      "holder": "ALI VELI"
    },
    "merchantOrderId": "1001",
    "description": "Siparis #1001",
    "customer": { "email": "ali@example.com", "ip": "203.0.113.7" },
    "returnUrl": "https://magaza.example/odeme/sonuc"
  }'

3D Secure gerektiğinde yanıt şu biçimde gelir:

201 Created
{
  "id": "pay_01J8X...",
  "object": "payment",
  "status": "requires_action",
  "amount": 15990,
  "currency": "TRY",
  "installment": 3,
  "secure": true,
  "provider": { "code": "garanti", "accountId": "acc_..." },
  "nextAction": {
    "type": "three_ds",
    "kind": "form",
    "method": "POST",
    "action": "https://bank.example/3d",
    "fields": { "...": "..." }
  }
}

Müşteriyi nextAction ile bankaya yönlendirin; doğrulama sonrası müşteri returnUrl'e döner. Ayrıntılar için 3D Secure akışı.

Kart verisi ve PCI kapsamı

Kart numarasını kendi sunucunuzdan API'ye göndermek sizi PCI DSS kapsamına sokar. Kart bilgisi toplamak istemiyorsanız hazır ödeme sayfasını kullanın: oturum oluşturur, müşteriyi yönlendirirsiniz; kart girişi bizim sayfamızda yapılır.

Sonraki adımlar

Sonraki →Kimlik doğrulama