Operation ID terpadu
Identifier ini menghubungkan pemain, jumlah, mata uang, metode pembayaran, payment provider, dan seluruh riwayat pemrosesan.
Dokumentasi / Payment Flow
Cara kerja Payment API
Pelajari payment flow lengkap: dari membuat deposit dan mengonfirmasi pembayaran hingga credit dana, withdrawal, refund, dan rekonsiliasi keuangan.
Deposit
pembuatan dan credit
Payout
verifikasi dan pengiriman
Status
konfirmasi operasi
Rekonsiliasi
kontrol finansial
Payment flow
Dari request hingga hasil akhir
01
Buat operasi
Catat pemain, jumlah, mata uang, metode pembayaran, dan operation ID yang unik.
02
Konfirmasi pembayaran
Arahkan pemain ke payment page, minta konfirmasi bank, atau proses pembayaran secara langsung.
03
Dapatkan status akhir
Periksa response payment provider dan konfirmasikan hasil akhir operasi.
04
Perbarui saldo dan pencatatan
Credit atau debit dana satu kali, catat fee, dan simpan operasi untuk rekonsiliasi.
Ringkasan
Setiap pembayaran melewati tahapan terkontrol
Platform memberikan operation ID internal, menghubungkannya dengan response payment provider, dan hanya mengubah kondisi finansial setelah hasil dikonfirmasi. Duplicate request tidak boleh membuat debit atau credit kedua.
Status yang jelas
Operasi hanya melewati tahapan yang diperbolehkan dan tidak mengubah hasil final tanpa koreksi terpisah.
Pencatatan finansial terpisah
Status pembayaran, perubahan saldo, fee, dan accounting entry saling terhubung tetapi diverifikasi secara terpisah.
Skenario deposit
Skenario deposit standar
Deposit dimulai dengan pembuatan operasi internal dan berakhir dengan credit satu kali setelah payment provider mengonfirmasi hasilnya.
01
Periksa request dan buat operasi
Platform memeriksa pemain, KYC, limit, mata uang, jumlah, dan metode pembayaran, lalu memberikan internal operation ID.
02
Kirim pembayaran ke provider
Provider menerima jumlah, mata uang, data pemain, return URL, notification URL, dan detail yang diperlukan.
03
Konfirmasi pembayaran
Pemain mengonfirmasi pembayaran di halaman eksternal, melalui 3-D Secure, atau aplikasi bank.
04
Terima konfirmasi dan credit dana
Setelah signature dan status akhir diverifikasi, platform menambah saldo pemain satu kali dan menyelesaikan operasi.
Withdrawal dan refund
Withdrawal, pembatalan, dan refund
Operasi keluar memerlukan pemeriksaan pemain, saldo tersedia, risiko, detail penerima, dan response akhir payment provider.
Verifikasi pemain
KYC, usia, status akun, limit, self-exclusion, dan metode withdrawal yang diperbolehkan.
Pemeriksaan risiko
AML, indikator fraud, wagering requirement, source of funds, dan persetujuan operator.
Reservasi jumlah
Jumlah diblokir pada saldo sampai hasil payout final diterima.
Kirim ke payment provider
Payout request terpisah dibuat dengan identifier unik dan detail penerima yang telah dikonfirmasi.
Menunggu hasil
Platform menerima status sementara dan tidak mendebit jumlah untuk kedua kalinya.
Refund
Refund dibuat sebagai operasi terpisah yang terhubung ke pembayaran awal dan memiliki jumlah sendiri.
Pembatalan
Pembatalan hanya dimungkinkan sebelum tahap irreversible dan tidak menggantikan refund untuk operasi yang sudah selesai.
Rekonsiliasi akhir
Laporan provider, data payout, fee, dan perubahan saldo harus menunjukkan hasil yang sama.
Status operasi
Model status yang direkomendasikan
Status internal menyatukan berbagai response payment provider ke dalam model yang seragam dan mudah dipahami platform.
Dibuat
Operasi dibuat di dalam platform tetapi belum dikirim atau belum diterima provider.
Memerlukan tindakan
Pemain perlu mengonfirmasi pembayaran, memasukkan detail, atau melakukan tindakan di bank.
Diproses
Provider telah menerima operasi tetapi hasil akhir belum dikonfirmasi.
Selesai
Operasi berhasil selesai dan perubahan saldo diterapkan satu kali.
Ditolak
Operasi berakhir dengan penolakan, alasan disimpan, dan tidak terjadi debit atau credit ulang.
Belum dikonfirmasi
Hasil akhir operasi tidak diketahui karena koneksi terputus, response delay, atau data yang bertentangan.
Hasil yang tidak diketahui tidak boleh dianggap gagal
Pembayaran mungkin sudah diterima provider meskipun response tidak datang tepat waktu. Periksa status terbaru atau tunggu konfirmasi terlebih dahulu sebelum memutuskan untuk mengulang operasi.
Keandalan dan rekonsiliasi
Perlindungan duplikasi dan rekonsiliasi keuangan
Keandalan Payment API ditentukan oleh perilaku aman 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 sudah ada dan tidak membuat operasi finansial baru.
Notifikasi berulang diperiksa berdasarkan event ID dan status pembayaran saat ini.
Perubahan saldo dihubungkan dengan payment ID dan diterapkan hanya satu kali.
Financial accounting dan rekonsiliasi
Simpan jumlah, fee, net credit, mata uang, dan provider ID secara terpisah.
Jangan menimpa catatan final secara retroaktif; buat koreksi terpisah.
Rekonsiliasi operasi API, laporan provider, perubahan saldo, dan payout.
Catat selisih, penyebabnya, PIC, dan hasil perbaikannya.
Testing
Apa yang perlu diuji sebelum peluncuran
Uji pembayaran berhasil, penolakan, koneksi terputus, konfirmasi berulang, hasil tidak diketahui, refund, dan rekonsiliasi keuangan.
Deposit dan withdrawal berhasil
Semua status sementara, konfirmasi, perubahan saldo, dan reporting akhir.
Operasi ditolak
Dana tidak cukup, detail salah, limit terlampaui, bank menolak, risk check, dan metode pembayaran tidak tersedia.
Koneksi terputus
Koneksi terputus setelah request dikirim, lalu konfirmasi datang belakangan atau diminta secara terpisah.
Duplicate request
Operasi atau konfirmasi yang sama datang kembali setelah pemrosesan selesai.
Refund dan pembatalan
Full refund dan partial refund, pembatalan sebelum diproses, serta larangan membatalkan operasi yang sudah selesai.
Rekonsiliasi
Jumlah, fee, status akhir, saldo, dan laporan provider sesuai setelah semua skenario.
Checklist sebelum peluncuran
Pembayaran produksi diaktifkan setelah status, konfirmasi, duplicate protection, saldo, dan financial reporting diverifikasi.
Test dan production environment menggunakan akses, notification endpoint, dan account yang berbeda.
Kembalinya pengguna ke situs tidak digunakan sebagai bukti pembayaran berhasil.
Signature dan event ID diverifikasi sebelum saldo diubah.
Deposit, withdrawal, dan refund dilindungi dari eksekusi berulang.
Status tidak diketahui diklarifikasi dengan provider dan diperiksa saat rekonsiliasi.
Error alert, laporan PSP, dan prosedur investigasi selisih telah disiapkan.
Perlu merancang payment flow?
Kirim daftar PSP, metode pembayaran, mata uang, pasar, aturan saldo, dan status. APIACE akan membantu menyusun deposit, withdrawal, refund, confirmation, dan rekonsiliasi keuangan.