একক operation number
এটি player, amount, currency, payment method, payment provider এবং পুরো processing history যুক্ত করে।
Documentation / Payment flow
Payment API কীভাবে কাজ করে
Deposit তৈরি ও payment confirmation থেকে fund credit, withdrawal, refund এবং financial reconciliation পর্যন্ত সম্পূর্ণ payment flow দেখুন।
Deposit
creation ও credit
Payout
verification ও sending
Status
operation confirmation
Reconciliation
financial control
Payment flow
Request থেকে final result পর্যন্ত
01
Operation তৈরি করুন
Player, amount, currency, payment method এবং unique operation number record করুন।
02
Payment confirm করুন
Player-কে payment page-এ পাঠান, bank confirmation নিন অথবা payment সরাসরি process করুন।
03
Final status নিন
Payment provider response যাচাই করে operation-এর final result confirm করুন।
04
Balance ও accounting update করুন
একবার fund credit বা debit করুন, fee account করুন এবং reconciliation-এর জন্য operation record করুন।
Overview
প্রতিটি payment controlled stage দিয়ে যায়
Platform operation-কে নিজস্ব number দেয়, provider response-এর সঙ্গে যুক্ত করে এবং confirmed result-এর পরই financial state বদলায়। Repeated request দ্বিতীয় debit বা credit তৈরি করা উচিত নয়।
স্পষ্ট status
Operation শুধু allowed stage অতিক্রম করে এবং আলাদা correction ছাড়া completed result বদলায় না।
পৃথক financial accounting
Payment status, balance change, fee এবং accounting entry পরস্পর linked হলেও আলাদাভাবে যাচাই করা হয়।
Deposit flow
সাধারণ deposit flow
Deposit internal operation তৈরি দিয়ে শুরু হয় এবং provider confirmation-এর পর একবার credit দিয়ে শেষ হয়।
01
Request যাচাই করে operation তৈরি করুন
Platform player, KYC, limit, currency, amount এবং payment method যাচাই করে, তারপর operation-কে internal number দেয়।
02
Payment provider-এ পাঠান
Provider amount, currency, player data, return URL, notification URL এবং প্রয়োজনীয় payment detail পায়।
03
Payment confirm করুন
Player external page, 3-D Secure অথবা banking app-এ payment confirm করে।
04
Confirmation নিয়ে fund credit করুন
Signature ও final status যাচাইয়ের পর platform একবার player balance বাড়ায় এবং operation complete করে।
Withdrawal ও refund
Withdrawal, cancellation ও refund
Outgoing operation-এ player, available balance, risk, payment detail এবং payment provider-এর final response যাচাই দরকার।
Player verification
KYC, age, account status, limit, self-exclusion এবং allowed withdrawal method।
Risk check
AML, fraud signal, wagering condition, source of funds এবং operator approval।
Amount reserve
Final payout result না আসা পর্যন্ত amount balance-এ blocked থাকে।
Payment provider-এ পাঠানো
Unique number এবং confirmed recipient detail-সহ আলাদা payout request তৈরি হয়।
Result-এর অপেক্ষা
Platform intermediate status গ্রহণ করে এবং amount আবার debit করে না।
Refund
Refund original payment-এর সঙ্গে linked এবং নিজস্ব amount-সহ আলাদা operation হিসেবে তৈরি হয়।
Rollback
Cancellation শুধু irreversible stage-এর আগে সম্ভব এবং completed operation-এর refund-এর বিকল্প নয়।
Final reconciliation
Provider report, payout data, fee এবং balance change একই result দেখাতে হবে।
Operation status
Recommended status model
Internal status বিভিন্ন payment provider response-কে platform-এর জন্য একক ও স্পষ্ট model-এ একত্রিত করে।
Created
Operation platform-এ তৈরি হয়েছে, কিন্তু এখনও provider-এ পাঠানো বা accepted হয়নি।
Action required
Player-কে payment confirm, detail দিতে অথবা bank-এ action করতে হবে।
Processing
Provider operation গ্রহণ করেছে, কিন্তু final result এখনও confirmed নয়।
Completed
Operation সফলভাবে completed; এরপর balance একবার পরিবর্তিত হয়।
Declined
Operation refusal-এ শেষ হয়েছে; reason সংরক্ষিত থাকে এবং আর debit বা credit হয় না।
Unconfirmed
Connection break, delayed response অথবা conflicting data-এর কারণে final result unknown।
Unknown result-কে failure ধরা যাবে না
সময়মতো response না পেলেও payment provider operation গ্রহণ করে থাকতে পারে। আগে current status request করুন বা confirmation-এর অপেক্ষা করুন, তারপরই retry নিয়ে সিদ্ধান্ত নিন।
Reliability ও reconciliation
Retry protection ও financial reconciliation
Payment API reliability repeated request, delayed confirmation এবং partial failure-এ safe behavior দ্বারা নির্ধারিত হয়।
Duplicate operation protection
প্রতিটি deposit, withdrawal এবং refund unique number পায়।
Repeated request existing result ফেরত দেয় এবং নতুন financial operation তৈরি করে না।
Repeated notification event number ও current payment state দিয়ে যাচাই করা হয়।
Balance change payment number-এর সঙ্গে linked এবং একবারই apply হয়।
Financial accounting ও reconciliation
Amount, fee, final credit amount, currency এবং provider number আলাদাভাবে সংরক্ষণ করুন।
Completed record পেছন থেকে rewrite না করে আলাদা correction তৈরি করুন।
API operation, provider report, balance change এবং payout reconcile করুন।
Discrepancy, reason, responsible person এবং correction result record করুন।
Testing
Launch-এর আগে কী যাচাই করবেন
Successful payment, decline, connection loss, repeated confirmation, unknown result, refund এবং financial reconciliation যাচাই করুন।
Successful deposit ও withdrawal
সব intermediate status, confirmation, balance change এবং final reporting।
Operation declined
Insufficient fund, invalid detail, limit exceeded, bank decline, risk check এবং unavailable payment method।
Connection loss
Request পাঠানোর পর connection break হয়, আর confirmation পরে আসে বা আলাদাভাবে request করা হয়।
Repeated request
একই operation বা confirmation processing শেষ হওয়ার পর আবার আসে।
Refund ও cancellation
Full ও partial refund, processing-এর আগে cancellation এবং completed operation cancel নিষিদ্ধ।
Reconciliation
সব scenario-এর পর amount, fee, final status, balance এবং provider report মিলে যায়।
Launch-পূর্ব checklist
Status, confirmation, duplicate protection, balance এবং financial reporting যাচাইয়ের পর production payment চালু হয়।
Test ও production environment আলাদা access, notification endpoint এবং account ব্যবহার করে।
User site-এ ফিরে আসাকে successful payment-এর proof হিসেবে ব্যবহার করা হয় না।
Balance বদলানোর আগে signature ও event number যাচাই করা হয়।
Deposit, withdrawal এবং refund repeated execution থেকে সুরক্ষিত।
Unknown status provider-এর কাছে clarify এবং reconciliation-এ verify করা হয়।
Error notification, PSP report এবং discrepancy review process configured আছে।
Payment flow design করতে চান?
PSP list, payment method, currency, market, balance rule এবং status দিন। APIACE deposit, withdrawal, refund, confirmation এবং financial reconciliation গুছিয়ে দিতে সাহায্য করবে।