Operation number moja
Huunganisha player, amount, currency, payment method, payment provider na full processing history.
Documentation / Payment Flow
Jinsi Payment API inavyofanya kazi
Pitia payment path kamili: kutoka kuunda deposit na kuthibitisha payment hadi crediting funds, withdrawals, refunds na financial reconciliation.
Deposit
creation na crediting
Payout
verification na sending
Statuses
operation confirmation
Reconciliation
financial control
Payment flow
Kutoka request hadi final outcome
01
Unda operation
Rekodi player, amount, currency, payment method na unique operation number.
02
Thibitisha payment
Mpeleke player kwenye payment page, omba bank confirmation au process payment moja kwa moja.
03
Pokea final status
Kagua payment provider response na uthibitishe final outcome ya operation.
04
Sasisha balance na accounting
Credit au debit funds mara moja, account for fee na rekodi operation kwa reconciliation.
Overview
Kila payment hupitia controlled stages
Platform huipa operation number yake, huiunganisha na payment provider response na kubadilisha financial state tu baada ya confirmed outcome. Repeated request haipaswi kuunda debit au credit ya pili.
Statuses zilizo wazi
Operation hupitia permitted stages pekee na haibadilishi completed outcome bila adjustment tofauti.
Financial accounting tofauti
Payment status, balance change, fee na accounting entry zimeunganishwa lakini hukaguliwa tofauti.
Deposit flow
Typical deposit flow
Deposit huanza na internal operation na kuishia na one-time credit baada ya payment-provider confirmation.
01
Validate request na unda operation
Platform hukagua player, KYC, limits, currency, amount na payment method, kisha huipa internal operation number.
02
Tuma payment kwa provider
Provider hupokea amount, currency, player data, return URL, notification URL na required payment details.
03
Thibitisha payment
Player huthibitisha payment kwenye external page, kupitia 3-D Secure au kwenye banking app.
04
Pokea confirmation na credit funds
Baada ya kuvalidate signature na final status, platform huongeza balance ya player mara moja na kukamilisha operation.
Withdrawal na refund
Withdrawals, cancellation na refunds
Outgoing operations zinahitaji verification ya player, available balance, risk, payment details na final response ya payment provider.
Player verification
KYC, age, account status, limits, self-exclusion na permitted withdrawal methods.
Risk checks
AML, fraud indicators, wagering conditions, source of funds na operator approval.
Reserve amount
Amount hushikiliwa kwenye balance hadi final payout outcome ipokelewe.
Tuma kwa payment provider
Payout request tofauti huundwa ikiwa na unique number na verified recipient details.
Subiri outcome
Platform hukubali intermediate statuses na haidebit amount tena.
Refund
Refund huundwa kama operation tofauti iliyounganishwa na original payment na amount yake.
Cancellation
Cancellation inawezekana tu kabla ya irreversible stage na haiwezi kuchukua nafasi ya refund kwa operation iliyokamilika tayari.
Final reconciliation
Provider report, payout data, fees na balance changes lazima zionyeshe result ileile.
Operation statuses
Recommended status model
Internal statuses hu-normalize responses tofauti za payment providers kuwa model moja iliyo wazi kwa platform.
Created
Operation imeundwa ndani ya platform lakini bado haijatumwa au kukubaliwa na provider.
Action required
Player anahitaji kuthibitisha payment, kuweka details au kufanya action na bank yake.
Processing
Provider amekubali operation, lakini final outcome bado haijathibitishwa.
Completed
Operation imekamilika successfully, kisha balance hubadilishwa mara moja.
Rejected
Operation imeishia kwa rejection huku reason ikihifadhiwa na bila debit au credit nyingine.
Unconfirmed
Operation outcome haijulikani kwa sababu ya connection failure, response delay au conflicting data.
Unknown outcome haiwezi kuchukuliwa kama rejection
Payment inaweza kuwa imekubaliwa na provider hata bila timely response. Kwanza omba current status au subiri confirmation, kisha ndipo uamue kama operation nyingine inahitajika.
Reliability na reconciliation
Duplicate protection na financial reconciliation
Reliability ya Payment API hutegemea safe behavior kwa repeated requests, delayed confirmations na partial failures.
Protection dhidi ya repeated operations
Kila deposit, withdrawal na refund hupata unique number.
Repeated request hurudisha existing result na haijengi financial operation mpya.
Repeated notification hukaguliwa dhidi ya event number na current payment state.
Balance change huunganishwa na payment number na hutumika mara moja tu.
Financial accounting na reconciliation
Hifadhi amount, fee, net amount, currency na provider reference tofauti.
Usiandike upya completed entry kwa retrospective change; unda adjustment tofauti.
Reconcile API operations, provider reports, balance changes na payouts.
Rekodi kila discrepancy, cause yake, owner na resolution result.
Testing
Nini cha kutest kabla ya launch
Test successful payment, rejection, connection loss, repeated confirmation, unknown outcome, refund na financial reconciliation.
Successful deposit na withdrawal
Intermediate statuses zote, confirmation, balance change na final reporting.
Operation rejection
Insufficient funds, invalid details, limit exceeded, bank rejection, risk review na unavailable payment method.
Connection loss
Connection hukatika baada ya request kutumwa, na confirmation huja baadaye au kuombwa tofauti.
Repeated requests
Operation au confirmation ileile hufika tena baada ya processing kukamilika.
Refund na cancellation
Full na partial refund, cancellation kabla ya processing na prohibition ya canceling completed operation.
Reconciliation
Amount, fee, final status, balance na provider report zinalingana baada ya scenarios zote.
Pre-launch checklist
Production payments huwashwa baada ya statuses, confirmations, duplicate protection, balances na financial reporting kuthibitishwa.
Test na production environments hutumia credentials, notification endpoints na accounts tofauti.
Kurudi kwa user kwenye tovuti hakutumiki kama proof ya successful payment.
Signature na event number huthibitishwa kabla ya kubadilisha balance.
Deposits, withdrawals na refunds zinalindwa dhidi ya repeated execution.
Unknown status hufafanuliwa na provider na kukaguliwa wakati wa reconciliation.
Error alerts, PSP reports na discrepancy-investigation process zimewekwa.
Unahitaji kubuni payment flow?
Tutumie PSP list, payment methods, currencies, markets, balance rules na statuses. APIACE itasaidia kupanga deposits, withdrawals, refunds, confirmation na financial reconciliation.