Brick API Documentation
Brick

Akun Virtual Panggilan Balik

Brick mengirimkan panggilan balik ini ke URL konfigurasi Anda ketika status pembayaran Akun Virtual berubah.

Gunakan panggilan balik ini untuk memperbarui transaksi VA yang cocok, merekonsiliasi jumlah yang dibayarkan, dan memicu alur kerja pemenuhan atau pembaruan saldo di sistem Anda.

Penanganan Panggilan Balik

  • Cocokkan callback menggunakan pembayaran Brick id, referenceId, dan nomor rekening VA.
  • Simpan detail metode pembayaran, termasuk kode pendek bank, nomor rekening, dan nama tampilan.
  • 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.
  • Jadikan handler Anda idempoten karena callback yang sama dapat dicoba ulang.
  • Gunakan titik akhir status VA jika panggilan balik tertunda atau keadaan internal Anda tidak jelas.

Bidang Kunci

BidangDeskripsi
idPengidentifikasi pembayaran Brick VA.
referenceIdReferensi transaksi atau pesanan Anda.
amountJumlah yang dibayarkan.
feeAmountJumlah biaya diterapkan pada pembayaran.
statusStatus pembayaran VA terbaru.
paymentMethod.instructionsDetail rekening bank dan VA yang digunakan oleh pembayar.

Contoh Panggilan Balik untuk Pembaruan Status Pembayaran VA:

Ketika status pembayaran berubah, kami akan mengirimkan pembaruan status ke URL panggilan balik Anda. Di bawah ini adalah contoh muatannya:

Buka VA

JSONCode
{ "data": { "id": "OP_a586fb49972e43ac9d92dc5199d361fc", "type": "virtual_account", "referenceId": "ref1234", "amount": "10000", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:06.000+07:00", "paymentId": "PAY_d2a60413161158d4ea7334957012bec1", "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name", "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" }, "paymentMethod": { "paymentId": "PAY_d2a60413161158d4ea7334957012bec1", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "attributes": { "referenceId": "ref1234", "amount": "10000", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:06.000+07:00", "paymentMethod": { "paymentId": "PAY_d2a60413161158d4ea7334957012bec1", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" } } } }

Tutup VA

JSONCode
{ "data": { "id": "CL_a30baa40a98d4c95aca2226cf1d1ef8e", "type": "virtual_account", "referenceId": "ref1234", "description": "Test Initial VA Close", "amount": "10000.0", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:30.000+07:00", "expiredAt": "2026-06-30T17:12:29.000+07:00", "paymentId": "PAY_a051cbf3abed1b1ff6c9d45167fed1d7", "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name", "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" }, "paymentMethod": { "paymentId": "PAY_a051cbf3abed1b1ff6c9d45167fed1d7", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "attributes": { "referenceId": "ref1234", "description": "Test Initial VA Close", "amount": "10000.0", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:30.000+07:00", "expiredAt": "2026-06-30T17:12:29.000+07:00", "paymentMethod": { "paymentId": "PAY_a051cbf3abed1b1ff6c9d45167fed1d7", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" } } } }
Last modified on