Genel Bakış
ödemehub gateway API'si kartı tek istekte çeker, 3D Secure ödeme başlatır; sipariş, abonelik ve ödeme linki için hazır ödeme sayfası açar; kartı saklar; iade ve iptali aynı ödemenin token'ıyla yapar; banka hesabınızın hareketlerini okur. Ödemenin hangi ödeme hesabından geçeceğini panelde tanımladığınız Gate kuralları seçer; taksit seçenekleri ve kur çevirisi aynı API'dedir.
Sunucunuzdan çağrılan bir REST/JSON API'sidir; bütün uçlar aynı adres yapısını kullanır:
{BASE_URL}/api/{team}/gateway/{uç}
Başlarken
- Panelde bir ödeme hesabı bağlayın. Sandbox'ta bütün modüller açıktır; canlıda anlaştığınız modülleri ödemehub açar.
- Kimlik bilgilerinizi panelin Entegrasyon sayfasından alın.
- Ortam ve adres yapısını öğrenin; entegrasyonu
https://sandbox.odemehub.comüzerinde geliştirin. - SDK istemcisini kurun ya da SDK kullanmadan isteği imzalayıp yanıtın imzasını doğrulayın.
- Yanıt biçimini, hata durumlarını ve istek sınırlarını işleyin.
- İhtiyacınız olan entegrasyon rehberini izleyin.
Uçlar
| Grup | Uçlar |
|---|---|
| Ödeme | secure-payment, regular-payment, retrieve-payments, retrieve-bin |
| İade ve iptal | refund-payment, cancel-payment |
| Sipariş | create-order, retrieve-orders, update-order |
| Ödeme linki | create-payment-link, retrieve-payment-links, update-payment-link, retrieve-link-payments |
| Abonelik | create-subscription, retrieve-subscriptions, update-subscription |
| Kayıtlı kart | create-saved-card, retrieve-saved-cards, update-saved-card, delete-saved-card |
| Banka hareketleri | retrieve-banks, create-bank-account, retrieve-bank-accounts, update-bank-account, delete-bank-account, retrieve-bank-transactions |
Her kaynak aynı kalıpla kullanılır:
| Uç | Metot | Ne yapar |
|---|---|---|
create-{kaynak} | POST | Her çağrıda yeni kayıt ve yeni token açar; reference tekil değildir. Token'ı saklayın; kayıt update-* ile değişir. Ayrıntı |
retrieve-{kaynaklar} | POST | Kayıtları token, referans ya da en fazla 7 günlük tarih aralığıyla listeler; yanıt her zaman listedir. Referansla sorgu o referanstaki kayıtları döner. Yanıt her zaman sayfalıdır (varsayılan ilk 250 kayıt); page / per_page ile sayfa seçilir: Sayfalama. |
update-{kaynak}/{token} | POST | Yalnızca gönderilen alanları değiştirir. |
Banka hareketleri bu kalıptan ayrılır: banka hesabında reference yoktur, hesaplar token'larıyla ya da hepsi birden sorulur; hareketler hesap token'larıyla ve sayfa sayfa gelir. Bkz. Banka Hareketleri.
Gateway'in size gönderdikleri
| Ne | Nereye | Ayrıntı |
|---|---|---|
| Dönüş POST'u | callback_url ya da success_url | Müşterinin tarayıcısından gelen, imzasız form. Dönüş POST'u |
| Webhook | Panelde Ödeme Ayarları → Webhook'ta olay için tanımlanan adres | Gateway sunucusundan gelen, imzalı JSON; yalnızca değişen kaydın token'ını taşır. Webhook |
SDK'lar
PHP, Node.js, Python ve Java SDK'ları istekleri imzalar, yanıtların imzasını doğrular ve yanıtları tipli nesnelere çevirir.