Brick API Documentation
Brick

Pencairan Reguler

Gunakan titik akhir Pencairan Reguler untuk membuat pembayaran Kirim Uang melalui aliran perutean reguler seperti RTOL Brick. Titik akhir ini berguna ketika tujuan, jumlah transaksi, atau pengaturan harga Anda sesuai dengan rute Reguler, dan ketika bisnis Anda perlu mengotomatiskan rekening bank atau mendukung pembayaran Ewallet, menyimpan referenceId klien, dan mengonfirmasi hasil akhir melalui pemeriksaan status atau panggilan balik pencairan.

Parameter permintaan

Parameter UtamaTipe DataDeskripsi
publicAccessTokenTaliToken akses satu kali dibuat menggunakan token autentikasi API
referensiIdTaliID referensi unik sebagai pengidentifikasi unik
jumlahbilangan bulatJumlah uang yang akan dicairkan
penerimaEmailTaliEmail penerima transfer. Sistem akan mengirimkan email dan bukti transfer PDF ke email ini.
deskripsiTaliString sembarang yang melekat pada objek. Seringkali berguna untuk menampilkan kepada pengguna tujuan transaksi tersebut. Batas panjang deskripsi adalah 255 karakter.
mengetikTaliSaat ini hanya mendukung transfer bank
Rekening bankNoTaliNomor akun pengguna penerima
bankShortCodeTaliKode pendek institusi dari rekening bank pengguna penerima
bankAccountHolderNameTaliNama rekening tujuan pengiriman dana.

Pengujian di Lingkungan Sandbox (Mode Testing)

Untuk mensimulasikan berbagai status transaksi, gunakan input contoh di bawah saat memanggil Disbursement API di lingkungan sandbox:

Pencairan Reguler

Kode Pendek BankNomor Rekening BankNama Pemilik Rekening BankJumlahStatus yang Diharapkan
MANDIRI112233445PROD ONLYRp29.999Completed
BRI112233445PROD ONLYRp10.000 - Rp500.000.000Processing
MANDIRI112233445PROD ONLYRp39.999Failed
SINARMAS112233445PROD ONLYRp10.000 - Rp500.000.000Failed with error 503 (Bank Under Maintenance)

Catatan Penting untuk Pengujian Sandbox:

  • Nomor Rekening Bank: Nomor apa pun dengan lebih dari 8 digit dapat digunakan.
  • Nama Pemilik Rekening: Harus selalu persis "PROD ONLY".
  • Jumlah: Harus berada dalam rentang Rp10.000 hingga Rp500.000.000.
  • Nilai-nilai ini di-hardcode di lingkungan sandbox kami untuk membantu mensimulasikan status respons tertentu.

Parameter respons

Parameter UtamaTipe dataDeskripsi
idTaliPengidentifikasi unik
mengetikTaliJenis transaksi
statusTaliStatus pencairan
dibuatPadaStempel WaktuWaktu saat respons dibuat.
kegagalanAlasanTaliAlasan transaksi gagal. Bidang ini hanya ditampilkan ketika transaksi gagal.
jumlahTaliJumlah uang yang akan dicairkan
jumlah biayaTaliBiaya transaksi
referensiIdTaliID referensi unik sebagai pengidentifikasi unik
deskripsiTaliString sembarang yang melekat pada objek. Seringkali berguna untuk menampilkan kepada pengguna tujuan transaksi tersebut. Batas panjang deskripsi adalah 255 karakter.
pencairanMethodTypeTaliSaat ini hanya mendukung transfer bank
Rekening bankNoTaliNomor akun pengguna
bankShortCodeTaliKode pendek institusi pengguna
bankAccountHolderNameTaliNama rekening tujuan pengiriman dana.
Nama bankTaliNama Institusi
status penyelesaianTaliStatus Penyelesaian Transaksi

❗️ Catatan Penting tentang Respons API

Jika sistem Anda tidak menerima respons HTTP 200 dengan status transaksi yang valid (PROCESSING, COMPLETED, atau FAILED), Anda tidak boleh menandai transaksi tersebut sebagai berhasil atau gagal.

Respons non-200 (misalnya, batas waktu, kesalahan 5xx, atau tidak ada respons) berarti hasilnya tidak pasti, dan Anda harus menganggap transaksi tersebut tertunda hingga Anda mengonfirmasi statusnya melalui Status API.

Last modified on