Copy page

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

Bidang	Deskripsi
id	Pengidentifikasi pembayaran Brick VA.
referenceId	Referensi transaksi atau pesanan Anda.
amount	Jumlah yang dibayarkan.
feeAmount	Jumlah biaya diterapkan pada pembayaran.
status	Status pembayaran VA terbaru.
paymentMethod.instructions	Detail 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

Code
{
  "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

Code
{
  "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"
      }
    }
  }
}