Crypto Casino
Torrent Dişli
API ödemeleri sağlayıcılar için nasıl çalışır
Ödeme API'si, uygulamanız ile sağlayıcı arasında "ödeme oluştur", "onay ver", "para iade et" 3DS, "müşteriye ödeme yap've" durum al'ı güvenilir, tekrarlanabilir çağrılara dönüştüren bir sözleşmedir. Kaputun altında düzinelerce kural var: tokenization, idempotency, webhooks, anti-dolandırıcılık, kuyruklar, SLA ve denetim. Aşağıda, bunun çoğu sağlayıcı için nasıl çalıştığına dair pratik bir harita bulunmaktadır.
Temel model: varlıkların neredeyse her zaman ne olduğu
Ödeme/Ücret - silme girişimi (yetkilendirme + yakalama veya hemen satın alma).
Ödeme Yöntemi - kart (PAN/token), banka hesabı/takma ad, cüzdan, yerel yöntem.
Müşteri - müşteri/ödeme kuruluşu (bazen isteğe bağlı).
Ödeme/Transfer - müşteriye/satıcıya giden ödeme.
Geri Ödeme/Geri Dönüş - orijinal ödemeye geri dönün (kapalı döngü).
Webhook Olayı - asenkron durum bildirimi.
Anlaşmazlık/Ters ibraz - ödeme ağı üzerinde anlaşmazlık (kartlar için).
Sipariş/Fatura - ödeme etrafında iş bağlamı.
Kimlik Doğrulama ve Güvenlik
API anahtarları/OAuth 2. 0/mTLS - sunucudan sunucuya.
Müşteri belirteçleri, ön uç için tek kullanımlık belirteçlerdir (sırları parlatmamak için).
Kart tokenization - PAN sağlayıcıya gider; Sadece simgeyi saklarsınız.
PCI DSS - bir PAN görürseniz, PCI bölgesindesiniz; Barındırılan alanları/SDK'ları önlemek ve kullanmak daha iyidir.
HMAC imzalı webhooks - etkinliğin sağlayıcıdan geldiğini kontrol eder.
Çift bölgeli mimari - genel ön (JS/SDK) ve özel arka uç (anahtarlar, risk mantığı).
Idempotency, kuyruklar ve tutarlılık
Üstbilgide Idempotency-Key: isteği tekrarlamak (zaman aşımı ile) bir kopya oluşturmaz.
Sizinle Outbox/Saga:'bir ödeme göndermek - deftere yazmak - webhook'u beklemek'kabul edildi.
Backoff ile Retrai - sadece geçici hatalar için. Geri alınabilir/geri alınamaz matris gereklidir.
Tipik uç noktalar (şemalar ve akış)
1) Kartlar (Visa/Mastercard, vb.)
POST/payments - bir ödeme oluşturun ('amount', 'currency', 'payment _ method _ token', 'capture' = false/true).
POST/payments/{ id }/confirm - шаг 3-D Secure 2 (challenge/redirect result).
POST/payments/{ id }/capture - yetkilendirmeden sonra yakalama (kısmi/tam).
POST/payments/{ id }/refund - iade (parçalar halinde, orijinal miktara kadar).
GET/payments/{ id} - статус (yetkilendirilmiş, yakalanmış, başarısız olmuş, requires_action).
3-D Secure/SCA: sağlayıcı meydan okuma için 'requires _ action' + 'client _ secret'/URL döndürür. Müşteri tarafından onaylandıktan sonra, ön taraf sonucu arka ucunuza döndürür -'/onaylayın 'çekersiniz.
2) A2A/Açık Bankacılık (Banka Tarafından Ödeme)
POST/payments - 'redirect _ url'den müşterinin bankasına yanıt.
Müşteri banka tarafından yetkilendirilmiştir - webhook 'ödeme. Başarılı/başarısız '.
GET/payments/{ id} - son durum (genellikle sadece asenkron).
3) Yerel yöntemler (PIX, PayID, FPX, iDEAL, vb.)
POST/payments - get 'qr _ code'/' deeplink'/' copy _ code'.
Kullanıcıyı göster, kayıtla ilgili webhook'u bekle.
Kod zaman aşımları ve TTL'ler sözleşmenin bir parçasıdır.
4) Ödemeler
POST/payouts ('amount', 'currency', 'destination _ token' или 'card _ token'/' bank _ alias').
GET/payouts/{ id} - статусы ('queued', 'sent', 'paid', 'failed').
Webhooks'un mesajı. Ücretli/başarısız 'gerçeğin kaynağıdır.
Kapalı döngü: Alternatiflerden önce kaynağa (tersine) ödeme yapılması tercih edilir.
Webhooks: "Gerçeğin kaynağı"
Olaylar: 'ödeme. beklemede/yetkili/yakalanmış/başarısız ',' ödeme. requires_action', geri ödeme. Başarılı ',' ödeme. Ücretli ',' anlaşmazlık. yaratılmış 'vb.
Teslimat: HMAC tarafından imzalanan geri ödemeler ile, genellikle'en az bir kez "- işleyiciyi idempotent tutun.
En iyi uygulama: webhook'u işleyin - defteri güncelleyin - 2xx'e yanıt verin. Bundan sonra herhangi bir iş mantığı asenkrondur.
Hata ve durum işleme
HTTP kodları: '2xx' başarı; '4xx' istemci hatası (doğrulama, dolandırıcılık/banka hatası, yanlış belirteç); '5xx' - sağlayıcı.
Причины отказов: 'Yetersiz _ fonlar', 'do _ not _ honor', 'çalıntı _ kart', 'limit _ exceeded', 'risk _ düşüş', 'banka _ kullanılamaz'.
Pencereleri yineleyin: 3DS için - durmadan geri çekemezsiniz; A2A için - yönlendirme/kod TTLs geçerlidir; Ödemeler için - geri ödeme.
Antifraud ve risk
Cihaz parmak izi ve davranış verileri - sağlayıcının JS/SDK'sı veya kendi katmanınız aracılığıyla.
Listeler: BIN riski, yöntemlerin siyah/beyaz listeleri/ASN/ülkeler.
Ayarlanabilir kapılar: yeni aletlerin limitleri, soğuma, hız, RG/AML eşik kontrolleri.
Politikalar: Puanlama + kurallarına göre 'pass/step-up/hold/block'.
Raylardaki özellikler
Kartlar: yetkilendirme ve takas (miktar değiştirilebilir), 3DS2, orijinal işlemdeki getiriler, anlaşmazlıklar/ters ibrazlar.
A2A/Open Bankacılık: yönlendirme/rıza akışı, yüksek apruv, düşük maliyet; Her şey eşzamansız ve büyük ölçüde bankaya bağlı.
Yerel hızlı: QR/alias, anlık webhook, TTL ve katı derleme.
OCT/Push-to-Card (kart ödemeleri): 3DS olmadan kart belirteçlerine, ihraççıdan Hızlı Fon desteğine ihtiyacınız var.
Sürüm oluşturma ve uyumluluk
API sürümleri:'/v1 ', üstbilgideki "veri sürümleri" veya phicheflags.
Geriye uyumlu değişiklikler: sadece tahribatsız alanlar.
Amortismanlar: geçiş sırasında eski sürümlerin, geçiş kılavuzlarının, yinelenen web kitaplarının geri çekilmesi için zamanlama.
Gözlemlenebilirlik ve SLA
Metrikler: p95 yetkilendirme/ödeme süresi, BIN/banka/yöntemle onay oranı, geri çekilmelerin paylaşımı, webhooks-lag.
Loglar: 'request _ id', 'idempotency _ key', 'payment _ id'ile korelasyon.
Uyarılar: Belirli bir banka/ülke için reddetmelerde bir artış, zaman aşımlarında bir artış, yinelenen olaylar.
Sweep ve Finans
Defter: Çift giriş, değiştirilemez kayıtlar, 'yetkili/yakalanan/iade edilen' durumlar.
Üç taraflı derleme: Defteriniz ↔ webhooks ↔ sağlayıcı/banka raporları.
Referanslar: 'provider _ reference', 'network _ reference', 'payout _ reference' tutun - bu desteği kaydeder.
Sandbox, sertifikasyon ve üretim
Sandbox: test belirteçleri/kartlar/bankalar, 3DS/redirects simülasyonu, webhook durumları için "düğmeler".
Test durumları: başarı/başarısızlık, 3DS mücadelesi, sağlayıcı zaman aşımı, yinelenen webhook, kısmi yakalama/geri ödeme, yönlendirme iptali, ödeme hatası.
Go-live: Prod tuşları, webhook etki alanları, IP-allowlist, anti-dolandırıcılık etkinleştirmek, sınırları ve uyarıları ayarlamak.
Mini örnekler (şematik)
Ödeme oluşturma (kart)
POST/v1/ödemeler
{
"Miktar": 9232, "para birimi": "EUR", "payment_method_token": "pm_tok_123," "yakalama": doğru, "meta veriler": {"order _ id": "ORD-1001"}
}
^ 200 {'id ":" pay_abc, "" status ":" requires_action, "" next_action": {"type": "redirect", "url": "..."}}Başarılı kayıtta Webhook
POST/webhooks
{
"type": "ödeme. Yakalanan "" data ": {'id": "pay _ abc", "amount": 9232, "currency": "EUR", "metadata": {"order _ id": "ORD-1001"}
}Ödeme
POST/v1/ödemeler
{
"Miktar": 5000, "para birimi": "EUR", "destination_token":" dest_tok_456, "" meta veriler ": {" user _ id ":'u _ 77"}
}Uygulama kontrol listesi
1. Anahtar mimarisi: sunucu sırları ayrı, istemci sırları - bir kerelik.
2. Idempotency: Her yazma çağrısında + idempotent webhook işleyicileri.
3. Webhooks: HMAC imzası, retrai, görev kuyruğu, gecikme izleme.
4. 3DS/SCA ve yönlendirmeler: iptalleri/zaman aşımlarını işleme, friend-UX'i tekrar deneme.
5. Antifraud/limitler: hız, yeni detaylar, kara listeler, RG/AML eşikleri.
6. Defter ve uzlaşma: çift giriş, üç taraflı uzlaşma, anomali uyarıları.
7. Orkestrasyon: yedek sağlayıcı, BIN/ülke/miktara göre yönlendirme kuralları.
8. İzleme: Panolar oranı/p95/retrays, bankalar/yöntemler tarafından uyarıları onaylar.
9. Yasal/PCI: tokenization, return policy, kapalı ödeme döngüsü.
10. Bozunma planı: kill-switch kanalı, kuyruklar, kritik işlemler için manuel mod.
Sık yapılan hatalar
PAN'ı PCI ve tokenizasyon olmadan yan tarafında depolamak.
Idempotency yok - zaman aşımına uğramış çift ödemeler/ödemeler.
Webhook'ları dikkate almadan senkronize yanıtlarda mantık.
Piyasaya bir sağlayıcı, geri dönüş/kaskadlar yok.
3DS geri alma/yönlendirme işlemi yok - kayıp geri dönüşüm kutuları.
Zayıf bir paket - "dondurulmuş've" kayıp "işlemler.
Net SLA'ların ve uyarıların olmaması - müşterinin gördüğü sorun, siz değil.
Mini-SSS
Hangisi daha güvenilir: senkron durum mu yoksa webhook mu?
Webhook gerçeğin kaynağıdır; Senkron yanıt - sadece "eylem kabul/gerekli".
3DS olmadan yapabilir misiniz?
Yönetmeliğe/riske bağlıdır. EC/UK'de - SCA zorunludur; Yüksek risk için, adım atmak daha iyidir.
Onay oranı nasıl artırılır?
BIN/banka/yöntem orkestrasyonu, yerel raylar, akıllı retralar, doğru tanımlayıcılar, düşük FPR anti-dolandırıcılık.
Ödeme neden "anında değil"?
Demiryoluna (OST/A2A/yerel), alıcının bankasına ve limitlerine bağlıdır. Dürüst bir SLA penceresi ve durum akışı yapalım.
API ödemeleri sadece "ödeme oluşturmak" değildir. "Bu disiplin: güvenli kimlik doğrulama, tokenizasyon, idempotency, asenkron webhooks, defter ve katlama, anti-fraud/AML, orkestrasyon ve izleme. Süreci bu şemaya göre oluşturun, yedek kanalları ve şeffaf UX'i saklayın - ödeme katmanınız hızlı, öngörülebilir ve bankaların ve sağlayıcıların başarısızlıklarına karşı dayanıklı olacaktır.