Kripto kazino
Torrent Gear
Üpjün edijilerden API tölegleri nähili işleýär
Töleg API, programma bilen üpjün edijiniň arasyndaky şertnama bolup, "töleg döretmek", "3DS tassyklamak", "serişdeleri yzyna gaýtarmak", "müşderä tölemek" we "status almak" ygtybarly, gaýtalanýan jaňlara öwrülýär. Kapotyň aşagynda onlarça düzgün bar: tokenizasiýa, idempotency, webhuklar, antifrod, nobatlar, SLA we audit. Aşakda - üpjün edijileriň köpüsinde munuň nähili işleýändiginiň amaly kartasy.
Esasy model: hemişe diýen ýaly haýsy zatlar bar
Payment/Charge - hasapdan çykarmak synanyşygy (authorize + capture ýa-da derrew purchase).
Payment Method - kart (PAN/token), bank hasaby/alias, gapjyk, ýerli usul.
Customer - müşderiniň/töleýjiniň düýp manysy (käwagt hökmany däl).
Payout/Transfer - müşderä/söwdagäre gidýän töleg.
Refund/Reversal - başlangyç tölege gaýdyp gelmek (closed-loop).
Webhook Event - status barada asenkron habar.
Dispute/Chargeback - töleg ulgamy boýunça jedel (kartlar üçin).
Order/Invoice - tölegiň töweregindäki iş mazmuny.
Tassyklamak we howpsuzlyk
API-açarlar/OAuth 2. 0/mTLS - serwer-a-serwer üçin.
Müşderi bellikleri - frontend üçin bir gezek ulanylýan bellikler (syrlary ýagtylandyrmazlyk üçin).
Kartlary bellemek - PAN üpjün edijä gidýär; Diňe belgi saklaýarsyňyz.
PCI DSS - PAN görseňiz, PCI zolagynda; hosted/SDK-dan gaça durmak we ulanmak has gowudyr.
HMAC webhook goly - wakanyň üpjün edijiden gelendigini barlamak.
Iki zolakly arhitektura - jemgyýetçilik fronty (JS/SDK) we hususy arka (açarlar, töwekgelçilik-logika).
Idempotency, nobatlar we yzygiderlilik
"Idempotency-Key" sözbaşysynda: haýyşyň gaýtalanmagy (wagt gutaranda) dublikat döretmeýär.
Outbox/Saga: "Töleg ibermek → depdere ýazmak → webhuk garaşmak" ylalaşyldy.
Backoff retrailer diňe wagtlaýyn ýalňyşlyklar üçin. Matrisa retryable/non-retryable - hökmany.
Adaty endpointler (shemalar we flow)
1) Kartlar (Visa/Mastercard we ş.m.)
POST/payments - töleg döretmek ('amount', 'currency', 'payment _ method _ token', 'capture' = false/true).
POST /payments/{id}/confirm — шаг 3-D Secure 2 (challenge/redirect result).
POST/payments/{ id }/capture - ygtyýarnamadan soň tutmak (bölekleýin/doly).
POST/payments/{ id }/refund - yzyna gaýtarmak (bölekleýin, başlangyç mukdaryna çenli).
GET /payments/{id} — статус (authorized, captured, failed, requires_action).
3-D Secure/SCA: üpjün ediji 'requires _ action' + 'client _ secret '/URL-ni challenge üçin yzyna gaýtarar. Müşderi tarapyndan tassyklanandan soň, front netijäni yzyna gaýtaryp berer → '/confirm '-i çekýärsiňiz.
2) A2A / Open Banking (Pay by Bank)
POST/payments → 'redirect _ url' -dan müşderiniň bankyna jogap.
Müşderi bankda hasaba alynýar → webhook 'payment. succeeded/failed`.
GET/payments/{ id} - soňky status (köplenç diňe asinxron).
3) Lokal usullar (PIX, PayID, FPX, iDEAL we ş.m.)
POST/payments → 'qr _ code '/' deeplink '/' copy _ code' alyň.
Ulanyja webhook okadygyňyza garaşýarsyňyz.
Taýmautlar we koda TTL - şertnamanyň bir bölegi.
4) Tölegler (payouts)
POST /payouts (`amount`, `currency`, `destination_token` или `card_token`/`bank_alias`).
GET /payouts/{id} — статусы (`queued`, `sent`, `paid`, `failed`).
Webhuki 'payout. paid/failed '- hakykat çeşmesi.
Ýapyk aýlaw: alternatiwalara çenli çeşmä (reversal) tölemek has gowudyr.
Webhook: "Hakykat çeşmesi"
Wakalar: 'payment. pending/authorized/captured/failed`, `payment. requires_action`, `refund. succeeded`, `payout. paid`, `dispute. created 'we ş.m.
Eltip bermek: HMAC tarapyndan gol çekilen retralar bilen, köplenç "azyndan bir gezek" → prosessoryň idempotentligini saklaň.
Iň oňat amal: webhuk → dolandyryjyny täzelemek → 2xx jogap bermek. Islendik iş logikasy soň - asinkron.
Hatalary we ýagdaýlary bejermek
HTTP-kodlar: '2xx' üstünlik; '4xx' müşderiniň ýalňyşlygy (walidasiýa, frod/bank şowsuzlygy, nädogry belgi); '5xx' - üpjün ediji.
Причины отказов: `insufficient_funds`, `do_not_honor`, `stolen_card`, `limit_exceeded`, `risk_decline`, `bank_unavailable`.
Gaýtalama penjireleri: 3DS üçin - tükeniksiz retra edip bolmaz; A2A üçin - redaktor/kod TTL hereket edýär; payouts üçin - backoff.
Antifrod we töwekgelçilik
Device-fingerprinting we özüni alyp baryş maglumatlary - JS/SDK üpjün edijisi ýa-da öz gatlagyňyz arkaly.
Sanawlar: BIN-töwekgelçilik, ýurduň/ASN/usullarynyň gara/ak sanawlary.
Düzgünleşdirilýän geýtlar: täze gurallara, "cool-off", velocity, RG/AML-bosagaly barlaglara çäklendirmeler.
Syýasatlar: 'pass/step-up/hold/block' + skoring düzgünlerine esaslanýar.
Relsler boýunça aýratynlyklar
Kartlar: awtorizasiýa vs kliring (mukdaryň üýtgemegi mümkin), 3DS2, başlangyç amal boýunça yzyna gaýtarmalar, jedeller/çarjbekler.
A2A/Open Banking: redirekt/consent-flow, ýokary agram, pes baha; hemme zat asinhron we banka gaty baglydyr.
Lokal çalt: QR/alias, derrew webhuk, TTL we berk ýygnak.
OCT/Push-to-Card (kartoçka tölegleri): kart bellikleri, emitentden 3DS-siz Fast Funds goldawy gerek.
Wersiýalaşdyrmak we gabat gelmek
API wersiýalary: '/v1 ', "data-wersiýalary" sözbaşy ýa-da ficheflaglar.
Backwards-compatible üýtgeşmeler: diňe ýok etmeýän meýdanlar.
Deprekasiýa: köne wersiýalary çykarmagyň tertibi, migrasiýa gidleri, migrasiýa wagtynda webhuklaryň dublikaty.
Synlamak we SLA
Metrikler: p95 awtorizasiýa/töleg wagty, BIN/bank/usul boýunça approve rate, retraýlaryň paýy, webhuk-lag.
Logy: 'request _ id', 'idempotency _ key', 'payment _ id' boýunça baglanyşyk.
Alertler: belli bir bank/ýurt boýunça şowsuzlyklaryň köpelmegi, wagtlaryň köpelmegi, wakalaryň dublikatlary.
Jemleme we maliýe
Dolandyryjy: goşa ýazgy, üýtgewsiz magazinesurnallar, statuslar 'authorized/captured/refunded'.
Üç taraplaýyn jemleme: siziň ledjeriňiz, webhuklaryňyz, üpjün edijiniň/bankyň hasabatlary.
Salgylanmalar: saklaň 'provider _ reference', 'network _ reference', 'payout _ reference' - bu sapporty tygşytlaýar.
Sandbox, Sertifikat we önümler
Sandbox: synag bellikleri/kartoçkalary/banklary, 3DS/redaktorlaryň simulýasiýasy, webhuk statuslary üçin "düwmeler".
Synag ýagdaýlary: üstünlik/şowsuzlyk, 3DS kynçylyk, üpjün edijiniň wagt wagty, webhukyň dublikaty, bölekleýin capture/refund, redaksiýanyň ýatyrylmagy, payout fail.
Go-live: önüm açarlary, webhook domenleri, IP-allowlist, antifrody açyň, çäkleri we aladalary goýuň.
Kiçi mysallar (shematiki)
Töleg (kart)
POST /v1/payments
{
"amount": 9232, "currency": "EUR", "payment_method_token": "pm_tok_123", "capture": true, "metadata": {"order_id": "ORD-1001"}
}
→ 200 { "id": "pay_abc", "status": "requires_action", "next_action": {"type":"redirect", "url":"..."} }Üstünlikli giriş barada webhuk
POST /webhooks
{
"type": "payment. captured", "data": {"id":"pay_abc","amount":9232,"currency":"EUR","metadata":{"order_id":"ORD-1001"}}
}Töleg (payout)
POST /v1/payouts
{
"amount": 5000, "currency": "EUR", "destination_token": "dest_tok_456", "metadata": {"user_id":"u_77"}
}Giriş barlagy
1. Açarlaryň arhitekturasy: serwer syrlary aýratyn, müşderiler - bir gezek ulanylýan.
2. Idempotency: her write-çagyryşda + idempotent webhook prosessorlary.
3. Webhuklar: HMAC-yň goly, retralary, wezipeleriň nobaty, laglara gözegçilik.
4. 3DS/SCA we redaktirlemeler: çalyşmalary/wagtlary gaýtadan işlemek, frendli-UX-ni gaýtalamak.
5. Antifrod/çäklendirmeler: velocity, täze jikme-jiklikler, gara sanawlar, RG/AML bosagalary.
6. Ledger we jemleme: iki gezek ýazgy, üç taraplaýyn deňeşdirme, anomaliýalaryň aladalary.
7. Orkestrasiýa: ätiýaçlyk üpjün ediji, BIN/ýurt/mukdar boýunça routing düzgünleri.
8. Gözegçilik: daşbordlar approve rate/p95/retralar, banklar/usullar boýunça alertler.
9. Kanuny/PCI: tokenizasiýa, yzyna gaýtarmak syýasaty, ýapyk aýlaw payouts.
10. Zaýalanma meýilnamasy: kanal kill-switch, nobatlar, möhüm amallar üçin el re modeimi.
Ýygy-ýygydan ýalňyşlyklar
PAN-lary PCI we tokenizasiýa bolmazdan öz tarapynda saklamak.
Taýmaut wagtynda tölegleriň/tölegleriň idempotency → dublynyň ýoklugy.
Webhuklary hasaba almazdan sinhron jogaplarda logika.
Bazara bir üpjün ediji, fallback/kaskadsyz.
3DS/re directorissýor → ýitirilen sebetleri ýok.
Gowşak ýygnamak → "asylan" we "ýitirilen" amallar.
SLA we alertleriň ýoklugy → bu meseläni siz däl-de, müşderi görýär.
Mini-FAQ
Has ygtybarly zat: sinhron status ýa-da webhuk?
Webhuk - hakykat çeşmesi; sinhron jogap - diňe "hereket kabul edildi/zerur".
3DS-siz edip bilersiňizmi?
Düzgünleşdirilmegine/töwekgelçiligine baglydyr. EC/UK - SCA hökmany; ýokary töwekgelçilik üçin step-up has gowudyr.
Approve rate nädip ýokarlandyrmaly?
BIN/bank/usuly boýunça orkestr, ýerli relsler, akylly retralar, dogry deskriptorlar, pes FPR bolan antifrod.
Näme üçin "derrew däl"?
Relse (OST/A2A/ýerli), alyjynyň bankyna we çäklerine baglydyr. Dogruçyl SLA penjiresini we status akymyny beriň.
API-tölegler diňe "töleg döretmek" däl. Bu düzgün: ygtybarly autentification → tokenization → idempotency → asinhron webhucks → ledger we gysgaça → antifrod/AML → orkestr we gözegçilik. Bu shema boýunça prosesi guruň, ätiýaçlyk kanallary we aç-açan UX saklaň - töleg gatlagyňyz çalt, öňünden aýdyp boljak we banklaryň we üpjün edijileriň şowsuzlyklaryna çydamly bolar.