Sağlayıcı ve Adapter Modeli
Provider catalog, config, adapter execution ve confirm orchestrator özetinin public anlatımı.
HSRC Pay'de sağlayıcı entegrasyonu tek bir JSON dosyasıyla canlıya alınan plugin modeli değildir. Catalog, method desteği, hesap provider config'leri ve confirm routing'i birlikte çalışır.
Bu sayfa internal registry veya credential detayı açmaz; entegrasyonu okurken hangi kavramların birbirine bağlandığını netleştirir.
Provider nedir?
Banka, PSP, cüzdan, sandbox veya simüle sağlayıcı kaydıdır. Kayıt tek başına ödeme çekmez: confirm’te ödeme yöntemi, uygun config, routing plan ve execution adımı gerekir.
Method ve config
| Kavram | Kısa anlam |
|---|---|
| Provider | Ödemeyi işleyebilen sistem (katalog kaydı) |
| Provider method | Desteklenen ağ, kart tipi, ülke vb. |
| Provider config | Hesaba bağlı credential ve kural seti; routing adayının kaynağı |
| Capabilities | 3DS, taksit, para birimi gibi uygunluk sinyalleri |
Merchant API'sinde adapter sınıf adı veya internal registry listesi yoktur. Confirm'te isteğe bağlı routing_strategy ile config veya provider identifier daraltılır; sonuç payment.status, confirmResult ve charge kayıtlarından okunur.
Execution sonucu (adapter düzeyi)
Confirm sonrası orchestrator özeti kabaca şu ailelerden birine düşer:
| Sonuç | Payment tarafında tipik yansıma |
|---|---|
| Başarı | SUCCEEDED veya AUTHORIZED (auto capture kapalıysa) |
| Ek adım gerekir | REQUIRES_ACTION + yönlendirme URL’si |
| Red / hata | Charge DECLINED veya FAILED; payment çoğunlukla REQUIRES_PAYMENT_METHOD |
Ham sağlayıcı cevabına göre UI veya muhasebe kurmayın; normalized status ve webhook’ları esas alın.
Confirm akışı (yüksek seviye)
Sandbox sağlayıcılar
Sandbox catalog gerçek banka veya card network değildir. Amaç production öncesi lifecycle, 3DS ve decline davranışını güvenli ortamda görmektir. Secure mode açıkken REQUIRES_ACTION üretmek normal bir test sonucudur.
Public dokümantasyon sınırı
- Credential, endpoint URL’leri ve internal mapping listeleri dokümanda yoktur.
- Tam PAN/CVV veya issuer veri seti paylaşılmaz.
- “YAML ile provider ekleme” gibi vaatler bu ürün anlatısının parçası değildir.