Copy page

บัญชีเสมือนโทรกลับ

Brick ส่งการโทรกลับนี้ไปยัง URL ที่คุณกำหนดค่าไว้เมื่อสถานะการชำระเงินของบัญชีเสมือนเปลี่ยนแปลง

ใช้การโทรกลับนี้เพื่ออัปเดตธุรกรรม VA ที่ตรงกัน กระทบยอดจำนวนเงินที่ชำระ และทริกเกอร์การดำเนินการตามคำสั่งซื้อหรืออัปเดตยอดคงเหลือในระบบของคุณ

การจัดการการโทรกลับ

• จับคู่การโทรกลับโดยใช้หมายเลขบัญชีการชำระเงิน Brick id, referenceId และ VA
• จัดเก็บรายละเอียดวิธีการชำระเงิน รวมถึงรหัสย่อของธนาคาร หมายเลขบัญชี และชื่อที่แสดง
• ส่งคืน HTTP 200 หลังจากที่ระบบของคุณยอมรับการติดต่อกลับแล้วเท่านั้น URL การทดสอบแดชบอร์ด / บันทึกและการทดสอบยังต้องใช้ JSON ACK พร้อมด้วยการทดสอบ Brick referenceId ที่แน่นอน
• ทำให้ตัวจัดการของคุณเป็น idempotent เนื่องจากสามารถลองโทรกลับเดียวกันได้
• ใช้จุดสิ้นสุดของสถานะ VA หากการโทรกลับล่าช้าหรือสถานะภายในของคุณไม่ชัดเจน

ฟิลด์สำคัญ

สนาม	คำอธิบาย
id	ตัวระบุการชำระเงิน Brick VA
referenceId	การอ้างอิงธุรกรรมหรือคำสั่งซื้อของคุณ
amount	จำนวนเงินที่ชำระ
feeAmount	จำนวนค่าธรรมเนียมที่ใช้กับการชำระเงิน
status	สถานะการชำระเงิน VA ล่าสุด
paymentMethod.instructions	รายละเอียดบัญชีธนาคารและ VA ที่ผู้ชำระเงินใช้

ตัวอย่างการโทรกลับสำหรับการอัปเดตสถานะการชำระเงิน VA:

เมื่อสถานะการชำระเงินเปลี่ยนแปลง เราจะส่งการอัปเดตสถานะไปยัง URL โทรกลับของคุณ ด้านล่างนี้เป็นตัวอย่างของเพย์โหลด:

เปิดเวอร์จิเนีย

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

ปิดเวอร์จิเนีย

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