Ödeme Endpoint'leri

Session oluşturulduktan sonra ödeme işlemlerini gerçekleştirmek için kullanılan endpoint'ler.

bilgi

Bu endpoint'ler genellikle checkout arayüzü (React widget) tarafından otomatik çağrılır. Server-to-server entegrasyon yapıyorsanız doğrudan kullanabilirsiniz.

---

Ödeme Yapma

POST /api/v1/payment/pay

İstek Gövdesi

{
  "session_id": "ses_a1b2c3d4e5f6g7h8i9j0k1l2",
  "payment_type": "creditcard",
  "card_holder_name": "AHMET YILMAZ",
  "card_number": "5388880000000055",
  "expire_month": "12",
  "expire_year": "2030",
  "cvc": "000",
  "is_3d": true,
  "installment_count": "1",
  "save_card": false
}

Ödeme Tipleri

payment_type	Açıklama	Ek Alanlar
creditcard	Kredi/Banka kartı	card_number, expire_month, expire_year, cvc
wire_transfer	Havale/EFT	—
wallet	Dijital cüzdan	wallet_id
shoppingcredit	Alışveriş kredisi	bank_code
papel	Papel ile ödeme	—

Başarılı Yanıt

{
  "success": true,
  "order_id": "ORD-a1b2c3d4e5f6g7h8i9j0k1l2",
  "status": "processing",
  "redirect_url": "https://3dsecure.bank.com/...",
  "message": "",
  "html_content": ""
}

3D Secure

is_3d: true olduğunda, yanıtta redirect_url veya html_content döner. Müşteriyi bu URL'e yönlendirmeniz veya HTML'i render etmeniz gerekir.

---

Taksit Sorgulama

POST /api/v1/payment/installments

{
  "session_id": "ses_a1b2c3d4e5f6g7h8i9j0k1l2",
  "bin_number": "538888"
}

Kart numarasının ilk 6 hanesini (bin_number) gönderin, o kart için geçerli taksit seçeneklerini alın.

---

BIN Sorgulama

POST /api/v1/payment/bin-check

{
  "session_id": "ses_xxx",
  "bin_number": "538888"
}

---

Ödeme Durumu Sorgulama

GET /api/v1/payment/status/{order_id}?session_id=ses_xxx

Yanıt

{
  "success": true,
  "order_id": "ORD-xxx",
  "status": "completed",
  "amount": 1000,
  "message": "Ödeme başarılı"
}

Durum Değerleri

Status	Açıklama
pending	Bekliyor
processing	İşleniyor
completed	Tamamlandı
failed	Başarısız
cancelled	İptal edildi

---

Havale/EFT Banka Seçenekleri

POST /api/v1/payment/wire-transfer-options?session_id=ses_xxx

---

Cüzdan Seçenekleri

POST /api/v1/payment/wallet-options?session_id=ses_xxx

---

Alışveriş Kredisi Seçenekleri

POST /api/v1/payment/shopping-credit-options?session_id=ses_xxx