Payouts

  • Dipublikasikan pada Oct 17, 2025
Prev Next

Sebelum menjalankan integrasi Anda secara live, kami menyarankan Anda untuk menguji integrasi Anda secara menyeluruh dalam mode development. Gunakan simulasi Test Mode kami untuk menyimulasikan berbagai skenario positif dan negatif dan memastikan alur dalam integrasi Anda ditangani dengan benar.

Catatan: Kami merekomendasikan penggunaan Postman collections untuk pengujian. Silakan lihat halaman integrasi postman kami untuk detail lebih lanjut tentang cara mengatur collections Anda.

Sebelum Anda memulai

Catatan Penting

Simulasi hanya tersedia dalam Test Mode. Pastikan Anda menggunakan API Key Development untuk menguji.

  • Pastikan Anda memiliki API Key yang tepat untuk mata uang yang ingin Anda uji

    • Satu mata uang = Satu akun dasbor = Satu API key

    • Jika Anda ingin melakukan payout ke mata uang: PHP, maka Anda harus membuat dasbor di mana negara operasinya adalah: Filipina dan membuat API Key dengan izin Money Out Read and Write dari dasbor tersebut

    • Jika Anda juga ingin melakukan payout ke mata uang: IDR, maka Anda harus membuat akun dasbor lain di mana negara operasinya adalah: Indonesia dan juga membuat API Key menggunakan akun dasbor tersebut

Panduan Pengujian

  • Uji pemanggilan semua endpoint Payouts yang Anda implementasikan

  • Uji sebanyak mungkin skenario simulasi sesuai dengan kasus penggunaan Anda

  • Pastikan event webhook yang Anda subscribe diterima dan ditangani dalam integrasi Anda

Skenario Simulasi

Panggil Create Payouts API menggunakan salah satu detail pengujian berikut untuk menyimulasikan skenario yang sedang Anda uji.

Skenario Positif

Skenario

Kriteria

Hasil yang Diharapkan

Payout Berhasil

Kirim permintaan Create Payout yang valid, dengan account_holder_name dan account_number apa pun

Payout akan berstatus SUCCEEDED

Pembatalan Payout Berhasil

Kirim permintaan Create Payout yang valid dengan channel bank, dan account_number = 131313

Status Payout akan tetap ACCEPTED. Anda kemudian dapat mencoba permintaan Pembatalan Payout.

Pembatalan Payout Berhasil - Payout Tunai

Kirim permintaan Create Payout yang valid dengan channel payout tunai, dan account_number = 141414

Status Payout akan tetap REQUESTED. Anda kemudian dapat mencoba permintaan Pembatalan Payout.

Skenario Negatif

Skenario

Kriteria

Hasil yang Diharapkan

Payout Gagal karena permintaan berisi idempotency key duplikat tetapi dengan payload yang sama

Coba payout dengan idempotency key duplikat dan payload yang sama persis.

Akan mengembalikan payout yang sama dengan permintaan asli.

Payout Gagal karena permintaan berisi idempotency key duplikat tetapi dengan payload yang berbeda

Coba payout dengan idempotency key duplikat yang aktif dan payload yang berbeda.

DUPLICATE_ERROR

Payout Gagal karena jaringan switching mengalami downtime

account_number: 123456

Payout akan FAILED dengan failure_code = TEMPORARY_TRANSFER_ERROR

Payout Gagal karena penolakan dari channel penerima

account_number: 999999

Payout akan FAILED dengan failure_code = REJECTED_BY_CHANNEL

Payout Gagal karena akun tujuan tidak valid

account_number: 121212

Payout akan FAILED dengan failure_code = INVALID_DESTINATION

Payout Tunai Gagal karena kedaluwarsa

channel_properties.recipient_given_names: “Justin Baby” expires_at: waktu kapan pun di masa depan

Payout akan EXPIRED setelah 2 menit

Payout Gagal karena saldo tidak mencukupi

Mulai payout dengan jumlah lebih besar dari saldo yang Anda miliki.

Payout akan FAILED dengan failure_code = INSUFFICIENT_BALANCE

Payout Gagal karena permintaan dilarang

Coba API key tanpa izin yang benar untuk melakukan permintaan.

REQUEST_FORBIDDEN_ERROR

Payout Gagal karena adanya pembalikan dari channel penerima

Kirim permintaan Create Payout yang valid dengan channel bank, dan account_number: 654321

Status Payout akan menjadi SUCCEEDED kemudian REVERSED dalam 5 menit