Brick sends this callback to your configured URL when a Virtual Account payment status changes.
Use this callback to update the matching VA transaction, reconcile the paid amount, and trigger fulfillment or balance update workflows in your system.
Callback Handling
Match the callback using the Brick payment id, referenceId, and VA account number.
Store the payment method details, including bank short code, account number, and display name.
Return HTTP 200 only after your system has accepted the callback. Dashboard Test URL / Save & Test also requires a JSON ACK with the exact Brick test referenceId.
Make your handler idempotent because the same callback can be retried.
Use the VA status endpoint if the callback is delayed or your internal state is unclear.
Key Fields
Field
Description
id
Brick VA payment identifier.
referenceId
Your transaction or order reference.
amount
Paid amount.
feeAmount
Fee amount applied to the payment.
status
Latest VA payment status.
paymentMethod.instructions
Bank and VA account details used by the payer.
Sample Callback for VA Payment Status Update:
When a payment status changes, we will send a status update to your callback URL. Below is an example of the payload:
