Brick API Documentation
Brick

Panggilan Balik Pencairan BI-FAST

Callback Pencairan BI-FAST memberi tahu titik akhir yang dikonfigurasikan ketika status pembayaran BI-FAST berubah. Gunakan payload panggilan balik ini untuk memperbarui catatan pembayaran internal, merekonsiliasi transfer yang selesai atau gagal, dan menjaga dasbor pelanggan atau operasi tetap selaras dengan status transaksi akhir Brick.

JSONCode
{ "data": { "id": "84jt9r94jr4r84r894jr8j4", "type": "disbursement", "attributes": { "referenceId": "ref-disbursement-1", "description": "ref-disbursement-1", "amount": "30000", "status": "completed", "settlementStatus":null, "createdAt": "2023-09-21T13:49:39.752+08:00", "disbursementMethod": { "type": "bank_transfer", "bankAccountNo": "12345678", "bankShortCode": "BCA", "bankAccountHolderName": "BUDI SUSANTO", "bankName" : "Bank Central Asia", "sender": { "name": "BUDI SUSANTO", "identityType": "KTP", "identityNumber": "350104635820003", "countryCode": "ID", "provinceCode": "35", "cityCode": "1226", "jobCode": "89", "address": "JAkarta Sudirman No 4", "placeOfBirth": "BAndung", "dateOfBirth": "2000-04-23" } } } } }
JSONCode
{ "data": { "id": "9cb8ba6c8aa644ff9a433ace9", "type": "disbursement", "attributes": { "referenceId": "sc-MAR-5437", "description": "Good Luck", "amount": "10000", "status": "failed", "settlementStatus": null, "createdAt": "2025-02-12T16:25:11.000+07:00", "errorCode": "5000100", "errorReason": "General Error", "errorDetail": { "code": "general_error", "message": "General Error", "action": "Please try again later or contact support if the issue persists.", "reason": "A general error occurred while processing the request. This may be due to a temporary issue on our end." }, "disbursementMethod": { "type": "bank_transfer", "bankAccountNo": "010800041187", "bankShortCode": "BCA", "bankAccountHolderName": "JOHN CENA", "bankName": "BCA" } } } }

Harap dicatat ketika Anda mengatur titik akhir panggilan balik Anda:

  • Callback method : POSTINGAN
  • Aplikasi Content type :/json
  • Kembalikan HTTP 200 hanya setelah sistem Anda menerima panggilan balik. URL Pengujian Dasbor/Simpan & Uji juga memerlukan JSON ACK dengan pengujian Brick yang sama persis dengan referenceId.
  • Tambahkan daftar putih ke server Brick untuk koneksi aman

Parameter Respon

Parameter UtamaTipe dataDeskripsi
idTaliPengidentifikasi unik
mengetikTaliJenis transaksi
statusTaliStatus pencairan
dibuatPadaStempel WaktuWaktu saat respons dibuat.
jumlahbilangan bulatJumlah uang yang akan dicairkan
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 transaksi
kode kesalahanTaliPengidentifikasi unik yang mewakili kesalahan yang terjadi selama transaksi. Lihat cara menangani kesalahan here .
alasan kesalahanTaliPenjelasan singkat mengenai error yang menyebabkan kegagalan transaksi.
detail kesalahanObjek JSONPerincian kesalahan secara mendetail, termasuk informasi spesifik tentang penyebab dan kemungkinan langkah penyelesaiannya.

Parameter Respons Tambahan:

pengirim (objek JSON)

Parameter UtamaTipe DataDeskripsiBatasan
namaTaliNama pengguna yang mengirim uang1. Alfa Numerik 2. Spasi Dibolehkan 3. Maks 40 Karakter
tipe identitasTaliNilai yang diperbolehkan hanya KTP/SIM/KITAS/NPWPNilai yang diperbolehkan hanya KTP/SIM/KITAS/NPWP
nomor identitasTaliNomor Identitas Pengguna1. Alfa Numerik 2. Min 10 karakter 3. Maks 16 Karakter
Kode negaraTaliKode negara dua huruf untuk pengirimNilai yang diperbolehkan: 2 karakter huruf besar
kode provinsiTaliKode provinsi dua huruf untuk pengirimNilai yang diperbolehkan: 2 karakter huruf besar
kode kotaTaliKode kota empat huruf untuk pengirimNilai yang diperbolehkan: 4 karakter huruf besar
kode pekerjaanTaliKode pekerjaan empat huruf untuk pengirimNilai yang diperbolehkan: 4 karakter huruf besar
alamatTaliAlamat pengguna1. Alfa Numerik 2. Spasi Dibolehkan 3. Maks 40 Karakter
tempat lahirTaliTempat lahir pengguna1. Alfa Numerik 2. Spasi diperbolehkan 3. Maks 40 Karakter
tanggal lahirTaliTanggal Lahir penggunaFormat YYYY-MM-DD

errorDetail (objek JSON)

Parameter UtamaTipe DataDeskripsi
kodeTaliKode kesalahan yang dapat dibaca mesin yang mengkategorikan kesalahan.
pesanTaliPesan kesalahan yang dapat dibaca manusia yang menjelaskan masalah tersebut.
tindakanTaliTindakan yang disarankan yang dapat diambil untuk mengatasi kesalahan tersebut.
alasanTaliKonteks tambahan yang menjelaskan alasan kesalahan terjadi.
Last modified on