Open VA

Server

สร้างและตรวจสอบการชำระเงิน Open VA ที่ใช้ซ้ำได้ ใช้ endpoint เหล่านี้เมื่อลูกค้าสามารถโอนยอดเงินที่ยืดหยุ่นไปยัง virtual account เดิม และระบบของคุณต้องกระทบยอดสถานะ Open VA

สถานะของ Open VA

GET

https://sandbox.onebrick.io

/v2/payments/gs/va/open

publicAccessToken (header)

ตรวจสอบสถานะการชำระเงินล่าสุดสำหรับ Open Virtual Account ใช้ endpoint นี้เมื่อ callbacks เกิดความล่าช้า เมื่อทีมสนับสนุนจำเป็นต้องตรวจสอบการชำระเงิน หรือเมื่องานกระทบยอดของคุณจำเป็นต้องยืนยันสถานะปัจจุบันของ VA ส่งตัวระบุ VA ที่จำเป็น และใช้การตอบกลับเพื่ออัปเดตบันทึกการชำระเงินภายใน

สถานะของ Open VA › query Parameters

vaId

string · required

รหัสเฉพาะของบัญชีเสมือน เช่น OP_xxxx

สถานะของ Open VA › Responses

200

status

integer

Default: 0

object

error

สร้าง Open VA

POST

https://sandbox.onebrick.io

/v2/payments/gs/va/open

publicAccessToken (header)

สร้าง Open Virtual Account ที่สามารถรับจำนวนเงินการชำระเงินที่ยืดหยุ่นจากลูกค้า ใช้ Open VA เมื่อผู้ชำระเงินสามารถโอนเงินจำนวนที่แตกต่างกันไปยังตัวระบุ VA เดียวกัน เช่น การเติมเงินในกระเป๋าสตางค์ หรือกระแสการระดมทุนในบัญชีที่นำมาใช้ซ้ำได้ จัดเก็บรายละเอียด VA ที่ส่งคืนโดย Brick และกระทบยอดการชำระเงินผ่าน callbacks หรือสถานะ Open VA endpoint

สร้าง Open VA › Request Body

bankShortCode

string · required

รหัสย่อของสถาบันของธนาคาร

Default: MANDIRI

referenceId

string · required

ID เฉพาะที่ถูกสร้างขึ้นโดยไคลเอ็นต์เพื่อติดตามแต่ละรุ่น VA (สูงสุด 255 อักขระ)

Default: test-VA-1

displayName

string · required

ชื่อที่แสดงในแพลตฟอร์มการชำระเงินของลูกค้า (สูงสุด 24 อักขระ)

Default: PRODONLY

สร้าง Open VA › Responses

200

status

integer

Default: 0

object

error

POST/v2/payments/gs/va/open

curl https://sandbox.onebrick.io/v2/payments/gs/va/open \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'publicAccessToken: <api-key>' \
  --data '{
  "bankShortCode": "MANDIRI",
  "referenceId": "test-VA-1",
  "displayName": "PRODONLY"
}'

Example Request Body

{
  "bankShortCode": "MANDIRI",
  "referenceId": "test-VA-1",
  "displayName": "PRODONLY"
}

json

Example Responses

{
    "status": 200,
    "data": {
				"message": "We have successfully generated the open VA",
        "id": "OP_SA123212SDS123123SAD11222",
        "referenceId": "BRICK1234",
				"bankShortCode": "MANDIRI",
        "accountNo": "130432138889902",
        "displayName": "BRICK"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

json

application/json

QR Code SNAP Close VA

สถานะของ Open VA

GET

https://sandbox.onebrick.io

/v2/payments/gs/va/open

publicAccessToken (header)

สถานะของ Open VA › query Parameters

vaId

string · required

รหัสเฉพาะของบัญชีเสมือน เช่น OP_xxxx

สถานะของ Open VA › Responses

200

status

integer

Default: 0

object

error

สร้าง Open VA

POST

https://sandbox.onebrick.io

/v2/payments/gs/va/open

publicAccessToken (header)

สร้าง Open VA › Request Body

bankShortCode

string · required

รหัสย่อของสถาบันของธนาคาร

Default: MANDIRI

referenceId

string · required

Default: test-VA-1

displayName

string · required

ชื่อที่แสดงในแพลตฟอร์มการชำระเงินของลูกค้า (สูงสุด 24 อักขระ)

Default: PRODONLY

สร้าง Open VA › Responses

200

status

integer

Default: 0

object

error