Ortamlar ve Adresler
Sandbox ve canlı
ödemehub iki ayrı adreste çalışır:
| Sandbox | Canlı | |
|---|---|---|
{BASE_URL} | https://sandbox.odemehub.com | https://app.odemehub.com |
| Hesap ve API anahtarları | sandbox'ta açılan hesaba ait | canlıda açılan hesaba ait |
| Mod | her zaman test | test ya da canlı |
| Modüller ve ücret | bütün modüller açık, ücret yok | anlaştığınız modülleri ödemehub açar; komisyon ve varsa aylık ücret bakiyenize yazılır |
Entegrasyonu sandbox'ta geliştirin. Sandbox'ta her ödeme, ödeme hesaplarının test ayarlarıyla işlenir; canlı moda geçilmez, gerçek para hareketi olmaz.
Sandbox'ta e-postalar gerçektir. Müşteriye e-posta seçeneği (emails_customer) açık bir kayıtta e-posta, fatura adresine yazılan adrese gider. Denemelerde kendi adresinizi kullanın. Ayrıntılar: E-postalar.
Canlıya çıkarken app.odemehub.com üzerinde hesap açın, oradaki çalışma alanının kimliğini ve API anahtarlarını alın. Kodda yalnızca BASE_URL, {team} ve anahtarlar değişir. İki adresteki hesaplar, çalışma alanları ve kayıtlar birbirinden bağımsızdır.
Dokümandaki örnekler sandbox adresini kullanır.
Adres yapısı
{BASE_URL}/api/{team}/gateway/{uç}
| Parça | Değer |
|---|---|
{BASE_URL} | https://sandbox.odemehub.com ya da https://app.odemehub.com; bkz. Sandbox ve canlı. |
{team} | Çalışma Alanı Kimliğiniz: panelin Entegrasyon sayfasındaki 10 haneli sayı, ör. 4829301756. |
{uç} | Çağrılan uç, ör. secure-payment. Liste için API Referansı. |
Örnek:
POST https://sandbox.odemehub.com/api/4829301756/gateway/secure-payment
Bütün uçlar POST ile çağrılır; sorgu uçları dahil. Bir kaydı değiştiren ya da silen uçlarda kaydın token'ı adreste de yer alır:
POST https://sandbox.odemehub.com/api/4829301756/gateway/retrieve-payments
POST https://sandbox.odemehub.com/api/4829301756/gateway/update-order/3b7e1f20-5c4a-4d8e-9f1b-7a6c5d4e3f21
Yanıtlardaki is_test alanı, kaydın hangi modda oluştuğunu gösterir.
Test ve canlı mod
Bu bölüm canlı adres (app.odemehub.com) içindir; sandbox her zaman test modundadır.
Canlı adreste test ve canlı için ayrı adres ya da ayrı API anahtarı yoktur. Hangi ortamın kullanılacağını çalışma alanının modu belirler:
| Test modu | Canlı mod | |
|---|---|---|
| Adres | aynı | aynı |
| API anahtarı ve gizli anahtar | aynı | aynı |
| Ödeme hesabının kullandığı ayarlar | hesabın test ayarları | hesabın canlı ayarları |
- Mod, panelden değiştirilir. Yeni açılan bir çalışma alanı test modunda başlar.
- Mod değiştiğinde sonraki bütün istekler yeni moda göre işlenir; istekte değişen bir alan yoktur.
- Kayıtlı kartlar ve abonelikler moda bağlıdır. Ayrıntılar: Test.
- Banka hesapları moda bağlı değildir: hesap her modda bankadaki gerçek hesaptan okunur.