Jumlah dan biaya pembayaran
amount adalah nilai pokok pembayaran yang Anda kirim, bukan laporan saldo bersih merchant. Pada contoh pesanan order-book-1001, amount: 125000 berarti nilai pokok Rp125.000.
Bedakan nilai-nilai ini
| Nilai | Makna |
|---|---|
Nilai pokok (amount) | Jumlah pesanan yang menjadi dasar pembayaran. |
| Biaya provider | Biaya metode pembayaran menurut konfigurasi yang berlaku. |
| Biaya platform | Biaya platform menurut konfigurasi yang berlaku. |
| Total pelanggan | Jumlah yang perlu dibayar pelanggan, termasuk biaya yang dibebankan kepadanya. |
| Merchant net | Nilai bersih untuk merchant berdasarkan perhitungan dan pencatatan keuangan. |
Jangan menganggap semua nilai ini sama. Jangan menghitung merchant net di frontend dengan mengurangi persentase yang dihard-code.
Kebijakan API publik saat ini
Pada jalur create payment API publik, biaya dibebankan ke pelanggan (CUSTOMER pada model internal). fee_bearer bukan parameter API publik dan tidak boleh ditambahkan ke body POST /v1/payments.
Konfigurasi biaya dan channel menentukan perhitungan checkout. Saat attempt dibuat, sistem menyimpan snapshot biaya untuk percobaan tersebut. Perubahan konfigurasi kemudian tidak boleh dianggap mengubah riwayat biaya payment yang sudah berjalan.
Respons payment publik tidak menyediakan rincian fee atau merchant net. Gunakan rincian pembayaran dan catatan keuangan yang tersedia di aplikasi untuk pemeriksaan operasional, bukan menebak biaya dari response amount.
Apa yang harus ditampilkan aplikasi Anda?
- Sebelum checkout, tampilkan nilai pesanan dari backend Anda.
- Jangan menjanjikan total akhir berdasarkan perhitungan fee lokal yang belum dikonfirmasi checkout.
- Biarkan checkout menyajikan jumlah yang harus dibayar sesuai konfigurasi.
- Jangan menyamakan status
paiddengan saldo yang sudah tersedia untuk penarikan.
Batas pengujian
Simulator membantu menguji kontrak dan perubahan status. Nilai biaya simulasi tidak menetapkan tarif produksi dan bukan bukti settlement dana nyata. Pemrosesan produksi masih dinonaktifkan.
Lanjutkan ke: payment dan status untuk tipe amount, atau checkout untuk alur pelanggan.