Genel Bakış
ödemehub gateway API'si, sunucunuzdan çağrılan bir REST/JSON API'sidir. Bütün uçlar POST ile çağrılır ve gövde JSON'dur. İstekler ve 200 yanıtları çalışma alanınızın gizli anahtarıyla HMAC-SHA256 ile imzalanır.
POST {BASE_URL}/api/{team}/gateway/{uç}
Başlarken
- Kimlik bilgilerinizi panelin Entegrasyon sayfasından alın.
- Ortam ve adres yapısını öğrenin; ilk denemeleri test modunda yapın.
- İsteği imzalayın ve yanıtın imzasını doğrulayın ya da bunu yapan bir SDK kullanın.
- Yanıt biçimini ve hata durumlarını işleyin.
- İhtiyacınız olan entegrasyon rehberini izleyin.
Uçlar
| Uç | Ne yapar |
|---|---|
secure-payment | 3D Secure ödeme başlatır; redirect_url döner. |
regular-payment | 3D Secure olmadan karttan çeker; yanıt ödemenin sonucudur. |
order-payment | Ödeme sayfasında ödenecek sipariş açar; checkout_url döner. |
retrieve-payment | Bir ödemenin sonucunu döner. |
retrieve-bin | Kart numarasının ilk hanelerinden kart bilgisini ve taksit seçeneklerini döner. |
refund-payment | Ödemenin tamamını ya da bir kısmını iade eder. |
cancel-payment | Ödemenin tamamını iptal eder. |
save-product | Ürün kataloğuna ürün kaydeder ya da günceller. |
subscription-payment | Abonelik açar; ilk dönem için checkout_url döner. |
retrieve-subscription | Aboneliğin durumunu döner. |
cancel-subscription | Aboneliği iptal eder. |
save-card | Ödeme yapmadan kart saklar. |
saved-cards | Müşterinin kayıtlı kartlarını listeler. |
default-saved-card | Kayıtlı bir kartı varsayılan yapar. |
delete-saved-card | Kayıtlı bir kartı siler. |
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 |
| Abonelik webhook'u | webhook_url | Gateway sunucusundan gelen, imzalı JSON. Abonelik webhook'u |
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.