Single operation number
ఇది player, amount, currency, payment method, payment provider మరియు full processing historyను link చేస్తుంది.
Documentation / Payment Flow
Payment API ఎలా పనిచేస్తుంది
Deposit create చేయడం మరియు payment confirm చేయడం నుండి funds credit, withdrawals, refunds మరియు financial reconciliation వరకు complete payment pathను చూడండి.
Deposit
creation మరియు crediting
Payout
verification మరియు sending
Statuses
operation confirmation
Reconciliation
financial control
Payment flow
Request నుండి final outcome వరకు
01
Operation create చేయండి
Player, amount, currency, payment method మరియు unique operation number record చేయండి.
02
Payment confirm చేయండి
Playerను payment pageకు redirect చేయండి, bank confirmation request చేయండి లేదా paymentను directగా process చేయండి.
03
Final status పొందండి
Payment provider response check చేసి operation final outcomeను confirm చేయండి.
04
Balance మరియు accounting update చేయండి
Fundsను ఒక్కసారి credit లేదా debit చేసి fee account చేసి reconciliation కోసం operation record చేయండి.
Overview
ప్రతి payment controlled stages ద్వారా వెళ్తుంది
Platform operationకు own number assign చేసి payment provider responseతో link చేస్తుంది మరియు confirmed outcome తర్వాత మాత్రమే financial state మార్చుతుంది. Repeated request రెండో debit లేదా credit create చేయకూడదు.
Clear statuses
Operation permitted stages ద్వారానే move అవుతుంది మరియు separate adjustment లేకుండా completed outcomeను మార్చదు.
Separate financial accounting
Payment status, balance change, fee మరియు accounting entry పరస్పరం link అయినప్పటికీ separately check చేయబడతాయి.
Deposit flow
Typical deposit flow
Deposit internal operationతో మొదలై payment-provider confirmation తర్వాత one-time creditతో ముగుస్తుంది.
01
Request validate చేసి operation create చేయండి
Platform player, KYC, limits, currency, amount మరియు payment method check చేసి internal operation number assign చేస్తుంది.
02
Paymentను providerకు పంపండి
Provider amount, currency, player data, return URL, notification URL మరియు required payment details పొందుతుంది.
03
Payment confirm చేయండి
Player external page, 3-D Secure లేదా banking app ద్వారా payment confirm చేస్తాడు.
04
Confirmation పొందించి funds credit చేయండి
Signature మరియు final status validate చేసిన తర్వాత platform player balanceను ఒక్కసారి పెంచి operation complete చేస్తుంది.
Withdrawal మరియు refund
Withdrawals, cancellation మరియు refunds
Outgoing operationsకు player, available balance, risk, payment details మరియు payment provider final response verification అవసరం.
Player verification
KYC, age, account status, limits, self-exclusion మరియు permitted withdrawal methods.
Risk checks
AML, fraud indicators, wagering conditions, source of funds మరియు operator approval.
Amount reserve చేయండి
Final payout outcome వచ్చే వరకు amount balanceలో hold చేయబడుతుంది.
Payment providerకు పంపండి
Unique number మరియు verified recipient detailsతో separate payout request create చేయబడుతుంది.
Outcome కోసం wait చేయండి
Platform intermediate statuses accept చేస్తుంది మరియు amountను మళ్లీ debit చేయదు.
Refund
Refund original paymentతో link అయిన separate operationగా, own amountతో create చేయబడుతుంది.
Cancellation
Cancellation irreversible stageకు ముందు మాత్రమే సాధ్యం; completed operationకు refundను ఇది replace చేయదు.
Final reconciliation
Provider report, payout data, fees మరియు balance changes same result చూపాలి.
Operation statuses
Recommended status model
Internal statuses వేర్వేరు payment-provider responsesను platformకు ఒక clear modelగా normalize చేస్తాయి.
Created
Operation platformలో create అయింది కానీ ఇంకా providerకు send కాలేదు లేదా provider accept చేయలేదు.
Action required
Player payment confirm చేయాలి, details enter చేయాలి లేదా bankతో action తీసుకోవాలి.
Processing
Provider operation accept చేసింది కానీ final outcome ఇంకా confirm కాలేదు.
Completed
Operation successfulగా complete అయింది; తర్వాత balance ఒక్కసారి మాత్రమే change అవుతుంది.
Rejected
Reason retain చేసి, మరో debit లేదా credit లేకుండా operation rejectionతో ముగిసింది.
Unconfirmed
Connection failure, response delay లేదా conflicting data వల్ల operation outcome తెలియదు.
Unknown outcomeను rejectionగా పరిగణించకూడదు
Timely response లేకపోయినా payment provider accept చేసి ఉండవచ్చు. ముందుగా current status request చేయండి లేదా confirmation కోసం wait చేయండి; తర్వాత మాత్రమే మరో operation అవసరమా నిర్ణయించండి.
Reliability మరియు reconciliation
Duplicate protection మరియు financial reconciliation
Payment API reliability repeated requests, delayed confirmations మరియు partial failures సమయంలో safe behaviorపై ఆధారపడి ఉంటుంది.
Repeated operations నుంచి protection
ప్రతి deposit, withdrawal మరియు refundకు unique number ఉంటుంది.
Repeated request existing result return చేస్తుంది మరియు కొత్త financial operation create చేయదు.
Repeated notification event number మరియు current payment stateతో check చేయబడుతుంది.
Balance change payment numberతో link అయి ఒక్కసారి మాత్రమే apply అవుతుంది.
Financial accounting మరియు reconciliation
Amount, fee, net amount, currency మరియు provider referenceను separately store చేయండి.
Completed entryను retrospectiveగా rewrite చేయవద్దు; separate adjustment create చేయండి.
API operations, provider reports, balance changes మరియు payoutsను reconcile చేయండి.
ప్రతి discrepancy, దాని cause, owner మరియు resolution result record చేయండి.
Testing
Launchకు ముందు ఏమి test చేయాలి
Successful payment, rejection, connection loss, repeated confirmation, unknown outcome, refund మరియు financial reconciliation test చేయండి.
Successful deposit మరియు withdrawal
అన్ని intermediate statuses, confirmation, balance change మరియు final reporting.
Operation rejection
Insufficient funds, invalid details, limit exceeded, bank rejection, risk review మరియు unavailable payment method.
Connection loss
Request send చేసిన తర్వాత connection drop అవుతుంది; confirmation తర్వాత వస్తుంది లేదా separately request చేయబడుతుంది.
Repeated requests
Processing complete అయిన తర్వాత అదే operation లేదా confirmation మళ్లీ వస్తుంది.
Refund మరియు cancellation
Full మరియు partial refund, processingకు ముందు cancellation మరియు completed operation cancel చేయడంపై prohibition.
Reconciliation
అన్ని scenarios తర్వాత amount, fee, final status, balance మరియు provider report match అవుతాయి.
Pre-launch checklist
Statuses, confirmations, duplicate protection, balances మరియు financial reporting verify చేసిన తర్వాత production payments enable చేయబడతాయి.
Test మరియు production environments వేర్వేరు credentials, notification endpoints మరియు accounts ఉపయోగిస్తాయి.
User websiteకు తిరిగిరావడం successful payment proofగా ఉపయోగించబడదు.
Balance మార్చే ముందు signature మరియు event number verify చేయబడతాయి.
Deposits, withdrawals మరియు refunds repeated execution నుంచి protectedగా ఉంటాయి.
Unknown status providerతో clarify చేసి reconciliation సమయంలో check చేయబడుతుంది.
Error alerts, PSP reports మరియు discrepancy-investigation process configure చేయబడ్డాయి.
Payment flow design చేయాలా?
PSP list, payment methods, currencies, markets, balance rules మరియు statuses పంపండి. APIACE deposits, withdrawals, refunds, confirmation మరియు financial reconciliationను structure చేయడంలో సహాయపడుతుంది.