Dökümantasyona hoş geldiniz
HSRC Pay dokümantasyonuna giriş: payment orchestration, sandbox, checkout, routing ve canlıya çıkış rotası.
Buradan başlayın
HSRC Pay bir ödeme butonu değil; ödeme davranışını modelleyen, test eden ve çalıştıran bir orchestration katmanıdır. Bu dokümantasyon, payment lifecycle, provider adapter, sandbox network, routing ve event/webhook disiplinini aynı ürün diliyle anlamanız için hazırlanmıştır.
HSRC Pay ne sağlar?
HSRC Pay klasik bir payment gateway anlatısına sığmaz. Merchant'ın ödeme niyetini, payment method verisini, provider seçimini, provider execution sonucunu, charge attempt'lerini, webhook/event delivery sürecini ve operasyonel görünürlüğü tek lifecycle altında toplar.
Amaç provider karmaşasını merchant için tek API, tek state modeli ve tek event disipliniyle yönetilebilir hale getirmektir.
Payment orchestration
Payment, charge, provider, routing ve webhook davranışını tek yaşam döngüsünde birleştirir.
Ödeme akışları
Create, confirm, requires_action, decline, capture, refund, void ve webhook haritasını açıklar.
Hosted checkout
Checkout Session ile ödeme deneyimini, 3DS handling'i ve redirect sonrası doğrulamayı yönetir.
Sağlayıcı ve adapter modeli
Provider catalog, config, adapter execution ve confirm orchestrator özetini anlatır.
Sandbox network
Gerçek para hareketi olmadan lifecycle, provider, issuer, 3DS ve decline davranışlarını test eder.
Routing simulation
Provider seçimi, capability matching, fallback ve retry kararlarını production öncesi doğrular.
Webhook delivery
Payment state değişikliklerinin merchant sistemine güvenilir ve idempotent şekilde taşınmasını açıklar.
API Reference
Endpoint bazlı request/response şemaları ve operasyonel API yüzeyi.
Nereden başlamalısınız?
Ürünü konumlandırın
HSRC Pay Genel Bakış ile platformun neden sadece gateway değil, provider bağımlılığını azaltan bir orchestration layer olduğunu anlayın.
Payment lifecycle'ı öğrenin
Ödeme Yaşam Döngüsü ve Confirm sayfasında payment oluşturma ile provider execution başlatma arasındaki farkı netleştirin.
Entegrasyon modelini seçin
Hosted checkout için Checkout Session Rehberi, API-only model için Ödeme Akışları sayfasından ilerleyin.
Sandbox'ta prova yapın
Sandbox Network, Sandbox Cards, 3DS Simulation ve Testing Declines ile success dışındaki davranışları da test edin.
Production readiness kontrolünü tamamlayın
Webhook, idempotency, trace, credential separation ve operasyon kontrollerini Integration Readiness ile doğrulayın.
Persona bazlı rota
| Profil | İlk okuma | Sonraki adım | Dikkat edilmesi gereken |
|---|---|---|---|
| İlk kez entegre olacak developer | HSRC Pay Genel Bakış | Ödeme Yaşam Döngüsü ve Confirm | Payment oluşturmak tahsilat başlatmak değildir |
| Hosted checkout kullanacak merchant | Checkout Session Rehberi | Webhook Delivery | Redirect sonucu tek başına nihai ödeme kanıtı değildir |
| API-only entegrasyon yapan ekip | Ödeme Akışları | Data Models | requires_action ve decline sonuçları handle edilmelidir |
| Provider/routing mimarisi inceleyen ekip | Sağlayıcı ve Adapter Modeli | Routing Simulation | Provider davranışı adapter ve confirm orchestrator diliyle okunmalıdır |
| QA/engineering sandbox testi yapan ekip | Sandbox Network | Testing Declines | Sadece success kartı ile test yeterli değildir |
Core concepts
| Kavram | Kısa anlamı |
|---|---|
| Payment | Merchant'ın almak istediği ödeme niyeti veya iş kaydı |
| Charge | Provider/rail seviyesindeki authorization veya finansal işlem denemesi |
| Confirm | Payment'ı provider execution sürecine taşıyan kontrollü adım |
| Payment Method | Kullanıcının ödeme yaptığı yöntem: card, wallet, bank transfer veya local method |
| Provider adapter | Sağlayıcıya özel pay / capture / refund / 3DS resume implementasyonu |
| Confirm orchestrator | Routing adaylarını dener; confirmResult ve lifecycle status üretir |
routing_strategy | Confirm API alanı (config veya provider identifier daraltma) |
| Normalized Result | Adapter kind (success, requires_action, declined, error) ile Payment status eşlemesi |
| Sandbox Network | Gerçek para hareketi yapmadan ödeme davranışını prova eden test ağı |
Production'a çıkmadan önce
- Payment ve Charge ayrımını ekip içinde netleştirin.
- Checkout redirect sonucunu webhook veya server-side sorgu ile doğrulayın.
requires_action, timeout, hard decline ve soft decline senaryolarını test edin.- Sandbox credential ve production credential sınırlarını ayırın.
- Card data, provider secrets, signature material ve raw provider payload loglarını maskeleyin.
- Webhook handler'ınızı idempotent tasarlayın.
- Trace/request id ile ödeme attempt'lerini takip edebildiğinizi doğrulayın.
Güvenlik sınırı
Sandbox ortamı gerçek para hareketi oluşturmaz. Production kartları, production credential'ları veya gerçek müşteri verileri sandbox test payload'larına taşınmamalıdır.