Business Route Haritası
Merchant segmentleri, entegrasyon rotaları ve sandbox-first production readiness yaklaşımı.
HSRC Pay’i “hangi API klasörü?” diye değil, “hangi iş ihtiyacı?” diye okumak bu haritanın amacı. Aynı altyapı; hızlı checkout isteyen perakendeci, kendi UI’ını koruyan SaaS veya çoklu sağlayıcı deneyen marketplace için farklı başlangıç noktaları sunar.
Business Route nedir?
Business Route, bir merchant'ın HSRC Pay içinde hangi ürün yolunu izlemesi gerektiğini gösteren karar haritasıdır.
Tipik sıra:
- Sandbox Network ile davranışı prova et.
- Hosted Checkout veya API-only entegrasyon modelini seç.
- Payment lifecycle ve webhook handling'i doğrula.
- Provider/routing ayarlarını production separation ile hazırla.
- Live operations aşamasında monitoring, trace, reconciliation ve routing optimization yap.
Müşteri segmentleri
| Segment | İhtiyaç | Önerilen entegrasyon | Kullanacağı temel sayfalar | Dikkat edilmesi gerekenler |
|---|---|---|---|---|
| Yeni merchant | Hızlı ve kontrollü ödeme kabulü | Hosted Checkout | Checkout Session, Sandbox Cards | Redirect sonucu webhook ile doğrulanmalı |
| SaaS platformu | Farklı müşteri/hesap sınırlarında ödeme yönetimi | API + Checkout karması | Payment Lifecycle, Data Models | Tenant/account sınırları net tutulmalı |
| Marketplace | Çoklu ödeme yöntemi ve operasyon görünürlüğü | API-only + webhook-first | Business Flow, Webhook Delivery | Payment/charge attempt ayrımı raporlamada korunmalı |
| Yüksek hacimli işletme | Routing, fallback, decline ve operasyon kontrolü | API-only + routing simulation | Routing Simulation, Testing Declines | Retry/fallback davranışı idempotent olmalı |
| Özel provider ihtiyacı olan kurum | Provider davranışını standart lifecycle'a bağlama | Provider catalog + config + adapter | Sağlayıcı ve Adapter Modeli, Sandbox Network | Credential ve internal registry public alana taşınmamalı |
Kullanım senaryoları
Hızlı ödeme kabulü
Merchant hosted checkout ile başlar. HSRC Pay ödeme formu, payment method toplama, secure mode handling ve redirect/return davranışını daha yönetilebilir hale getirir.
API-only orchestration
Teknik ekip kendi arayüzünü korur: create, confirm, REQUIRES_ACTION, decline, capture, refund, cancel ve webhook’u kendi akışında yönetir.
Routing ve fallback odaklı operasyon
Merchant birden fazla provider veya provider config ile çalışır. Routing engine provider capability, rule, amount, currency, payment method ve sandbox scenario gibi girdilerle route kararını test edilebilir hale getirir.
Entegrasyon rotaları
| Rota | Ne zaman seçilir? | Teknik sonuç |
|---|---|---|
| Sandbox-first hosted checkout | Hızlı devreye alma ve düşük frontend yükü istendiğinde | Checkout Session, sandbox cards, webhook doğrulama |
| API-only payment flow | UI tamamen merchant tarafında kalacaksa | Payment create/confirm, next action handling, webhook-first state |
| Provider config route | Provider behavior yönetimi kritikse | Provider catalog, config, adapter execution, normalized result |
| Routing simulation route | Çoklu provider ve fallback davranışı test edilecekse | Candidate plan, route trace, retry/fallback doğrulama |
Sandbox-first yaklaşımı
Sandbox ortamı oyuncak değildir; production öncesi ödeme davranışını prova ettiğiniz mühendislik alanıdır.
Sandbox'ta yalnızca başarılı payment değil, şu davranışlar test edilmelidir:
- 3DS challenge ve resume
- Hard decline ve soft decline
- Provider timeout ve issuer unavailable
- Capture/refund/void
- Webhook retry ve idempotency
- Routing fallback
Production readiness
Production'a geçmeden önce:
- Sandbox ve production credential'ları ayrılmalı.
- Provider credential'ları public dokümandan ve uygulama loglarından ayrı, güvenli secret yönetimi sınırında tutulmalı.
- Payment/charge state transitions ekip tarafından anlaşılmalı.
- Webhook handler duplicate delivery için dayanıklı olmalı.
- Dashboard/trace üzerinden provider attempt'leri izlenebilmeli.
Operasyon sonrası
Live operations yalnızca ödeme almak değildir. Payment infrastructure ekipleri şu metrikleri izlemelidir:
- Provider bazlı success/decline dağılımı
- Fallback kullanım oranı
- 3DS requires_action completion oranı
- Webhook delivery failure ve retry sayısı
- Refund, void ve capture operasyonları
- Trace bazlı incident analizi
Hangi müşteri hangi route'u seçmeli?
Hızlı başlamak istiyorsanız Hosted Checkout. UI kontrolü ve özel backend akışınız varsa API-only. Provider davranışı, routing ve fallback kritikse Sağlayıcı ve Adapter modeli + Routing Simulation rotasından ilerleyin.
Roadmap veya future capability olarak işaretlenmemiş hiçbir alanı üretimde mevcut garanti gibi değerlendirmeyin; canlı entegrasyon öncesinde güncel API Reference ve environment ayarlarınızı doğrulayın.
Sonraki adımlar
- Hosted ödeme için Checkout Session Rehberi
- API akışları için Ödeme Akışları
- Sandbox prova için Sandbox Network
- Production kontrolü için Integration Readiness