Ana içeriğe geç

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​

  1. 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.
  2. Kimlik bilgilerinizi panelin Entegrasyon sayfasından alın.
  3. Ortam ve adres yapısını öğrenin; entegrasyonu https://sandbox.odemehub.com üzerinde geliştirin.
  4. SDK istemcisini kurun ya da SDK kullanmadan isteği imzalayıp yanıtın imzasını doğrulayın.
  5. Yanıt biçimini, hata durumlarını ve istek sınırlarını işleyin.
  6. İhtiyacınız olan entegrasyon rehberini izleyin.

Uçlar​

GrupUçlar
Ödemesecure-payment, regular-payment, retrieve-payments, retrieve-bin
İade ve iptalrefund-payment, cancel-payment
Siparişcreate-order, retrieve-orders, update-order
Ödeme linkicreate-payment-link, retrieve-payment-links, update-payment-link, retrieve-link-payments
Abonelikcreate-subscription, retrieve-subscriptions, update-subscription
Kayıtlı kartcreate-saved-card, retrieve-saved-cards, update-saved-card, delete-saved-card
Banka hareketleriretrieve-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çMetotNe yapar
create-{kaynak}POSTHer ç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}POSTKayı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}POSTYalnı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​

NeNereyeAyrıntı
Dönüş POST'ucallback_url ya da success_urlMüşterinin tarayıcısından gelen, imzasız form. Dönüş POST'u
WebhookPanelde Ödeme Ayarları → Webhook'ta olay için tanımlanan adresGateway 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.