Operation ID bersepadu
Identifier ini menghubungkan pemain, jumlah, mata wang, kaedah pembayaran, payment provider, dan keseluruhan rekod pemprosesan.
Dokumentasi / Payment Flow
Cara kerja Payment API
Ketahui lebih lanjut payment flow lengkap: dari membuat deposit dan mengesahkan pembayaran hingga credit dana, withdrawal, refund, dan rekonsiliasi kewangan.
Deposit
penciptaan dan credit
Payout
pengesahan dan penghantaran
Status
pengesahan operasi
Rekonsiliasi
kawalan kewangan
Payment flow
Dari request hingga hasil akhir
01
Buat operasi
Catat pemain, jumlah, mata wang, kaedah pembayaran, dan operation ID yang unik.
02
Pengesahan pembayaran
Arahkan pemain ke payment page, minta pengesahan bank, atau proses pembayaran secara langsung.
03
Dapatkan status akhir
Semak response payment provider dan konfirmasikan hasil akhir operasi.
04
Perbarui baki dan perekodan
Credit atau debit dana satu kali, catat fee, dan simpan operasi untuk rekonsiliasi.
Ringkasan
Setiap pembayaran melalui tahap terkawal
Platform memberikan operation ID dalaman, menghubungkannya dengan response payment provider, dan hanya mengubah keadaan kewangan selepas hasil disahkan. Duplicate request tidak boleh membuat debit atau credit kedua.
Status yang jelas
Operasi hanya melalui tahap yang dibenarkan dan tidak mengubah hasil final tanpa pembetulan berasingan.
Perekodan kewangan berasingan
Status pembayaran, perubahan baki, fee, dan accounting entry saling bersambung tetapi disahkan secara berasingan.
Senario deposit
Senario deposit standar
Deposit bermula dengan penciptaan operasi dalaman dan berakhir dengan credit satu kali selepas payment provider mengesahkan hasilnya.
01
Semak request dan buat operasi
Platform menyemak pemain, KYC, had, mata wang, jumlah, dan kaedah pembayaran, kemudian memberikan dalaman operation ID.
02
Hantar pembayaran ke provider
Provider menerima jumlah, mata wang, data pemain, return URL, notification URL, dan butiran yang diperlukan.
03
Pengesahan pembayaran
Pemain mengesahkan pembayaran di halaman luaran, melalui 3-D Secure, atau aplikasi bank.
04
Terima pengesahan dan credit dana
Selepas signature dan status akhir disahkan, platform menambah baki pemain satu kali dan menyelesaikan operasi.
Withdrawal dan refund
Withdrawal, pembatalan, dan refund
Operasi keluar memerlukan semakan pemain, baki tersedia, risiko, butiran penerima, dan response akhir payment provider.
Pengesahan pemain
KYC, umur, status akaun, had, self-exclusion, dan kaedah withdrawal yang dibenarkan.
Semakan risiko
AML, penunjuk fraud, wagering requirement, source of funds, dan persetujuan operator.
Reservasi jumlah
Jumlah disekat pada baki sampai hasil payout final diterima.
Hantar ke payment provider
Payout request berasingan dibuat dengan identifier unik dan butiran penerima yang telah disahkan.
Menunggu hasil
Platform menerima status sementara dan tidak mendebit jumlah untuk kedua kalinya.
Refund
Refund dibuat sebagai operasi berasingan yang bersambung ke pembayaran awal dan memiliki jumlah sendiri.
Pembatalan
Pembatalan hanya dimungkinkan sebelum tahap irreversible dan tidak menggantikan refund untuk operasi yang telah selesai.
Rekonsiliasi akhir
Laporan provider, data payout, fee, dan perubahan baki mesti menunjukkan hasil yang sama.
Status operasi
Model status yang disyorkan
Status dalaman menggabungkan pelbagai response payment provider ke dalam model yang seragam dan mudah difahami platform.
Dibuat
Operasi dibuat di dalam platform tetapi belum dihantar atau belum diterima provider.
Memerlukan tindakan
Pemain perlu mengesahkan pembayaran, memasukkan butiran, atau melakukan tindakan di bank.
Diproses
Provider telah menerima operasi tetapi hasil akhir belum disahkan.
Selesai
Operasi berjaya selesai dan perubahan baki digunakan satu kali.
Ditolak
Operasi berakhir dengan penolakan, sebab disimpan, dan tidak berlaku debit atau credit semula.
Belum disahkan
Hasil akhir operasi tidak diketahui kerana sambungan terputus, response delay, atau data yang bertentangan.
Hasil yang tidak diketahui tidak boleh dianggap gagal
Pembayaran mungkin telah diterima provider meskipun response tidak datang tepat masa. Semak status terkini atau tunggu pengesahan terlebih dahulu sebelum memutuskan untuk mengulangi operasi.
Kebolehpercayaan dan rekonsiliasi
Perlindungan duplicate dan rekonsiliasi kewangan
Kebolehpercayaan Payment API ditetapkan oleh tingkah laku selamat terhadap duplicate request, delayed confirmation, dan partial failure.
Perlindungan terhadap operasi berulang
Setiap deposit, withdrawal, dan refund mendapat identifier unik.
Duplicate request mengembalikan hasil yang sedia ada dan tidak membuat operasi kewangan baharu.
Notifikasi berulang disemak berdasarkan event ID dan status pembayaran semasa ini.
Perubahan baki dihubungkan dengan payment ID dan digunakan hanya satu kali.
Financial accounting dan rekonsiliasi
Simpan jumlah, fee, net credit, mata wang, dan provider ID secara berasingan.
Jangan menimpa rekod final secara retroaktif; buat pembetulan berasingan.
Rekonsiliasi operasi API, laporan provider, perubahan baki, dan payout.
Catat selisih, penyebabnya, PIC, dan hasil perbaikannya.
Testing
Apa yang perlu diuji sebelum pelancaran
Uji pembayaran berjaya, penolakan, sambungan terputus, pengesahan berulang, hasil tidak diketahui, refund, dan rekonsiliasi kewangan.
Deposit dan withdrawal berjaya
Semua status sementara, pengesahan, perubahan baki, dan reporting akhir.
Operasi ditolak
Dana tidak mencukupi, butiran salah, had melebihi had, bank menolak, risk check, dan kaedah pembayaran tidak tersedia.
Sambungan terputus
Sambungan terputus selepas request dihantar, kemudian pengesahan datang belakangan atau diminta secara berasingan.
Duplicate request
Operasi atau pengesahan yang sama datang semula selepas pemprosesan selesai.
Refund dan pembatalan
Full refund dan partial refund, pembatalan sebelum diproses, serta larangan membatalkan operasi yang telah selesai.
Rekonsiliasi
Jumlah, fee, status akhir, baki, dan laporan provider sesuai selepas semua senario.
Senarai semak sebelum pelancaran
Pembayaran produksi diaktifkan selepas status, pengesahan, duplicate protection, baki, dan financial reporting disahkan.
Test dan production environment menggunakan akses, notification endpoint, dan account yang berbeza.
Kembalinya pengguna ke laman web tidak digunakan sebagai bukti pembayaran berjaya.
Signature dan event ID disahkan sebelum baki diubah.
Deposit, withdrawal, dan refund dilindungi dari pelaksanaan berulang.
Status tidak diketahui diklarifikasi dengan provider dan disemak semasa rekonsiliasi.
Error alert, laporan PSP, dan prosedur investigasi selisih telah disediakan.
Perlu merancang payment flow?
Hantar senarai PSP, kaedah pembayaran, mata wang, pasaran, peraturan baki, dan status. APIACE akan membantu menyusun deposit, withdrawal, refund, confirmation, dan rekonsiliasi kewangan.