BIFAST Disbursement

Server

สร้างการโอนเงินผ่านธนาคาร BI-FAST แบบเรียลไทม์ผ่าน Brick Send Money ใช้แท็กนี้เมื่อคุณต้องการช่องทางการจ่ายเงินที่เร็วขึ้น รายละเอียดธนาคารของผู้รับ ข้อมูลผู้ส่ง ข้อมูลอ้างอิง IDs, callbacks และการติดตามสถานะ

BIFAST Disbursement API

POST

https://sandbox.onebrick.io

/v2/payments/gs/bifast-disbursements

publicAccessToken (header)

สร้างการเบิกจ่าย BI-FAST สำหรับการจ่ายเงินผ่านธนาคารแบบเกือบเรียลไทม์ผ่าน Brick Send Money ระบุจำนวนเงิน reference ID รายละเอียดธนาคารของผู้รับ ข้อมูลผู้ส่ง และส่วนหัวการตรวจสอบสิทธิ์ที่จำเป็น Brick ส่งคืนบันทึกการชำระเงินและประมวลผลการโอนแบบอะซิงโครนัส ใช้ callbacks และจุดสิ้นสุดการสอบถามสถานะเพื่อกระทบยอดสถานะการจ่ายเงินสุดท้ายหลังจากส่ง

การทดสอบในสภาพแวดล้อม Sandbox (โหมด Testing)

เพื่อจำลองสถานะธุรกรรมต่างๆ ให้ใช้อินพุตตัวอย่างด้านล่างเมื่อเรียก Disbursement API ในสภาพแวดล้อม sandbox:

การเบิกจ่าย BI-Fast

รหัสย่อธนาคาร	เลขที่บัญชีธนาคาร	ชื่อเจ้าของบัญชีธนาคาร	จำนวนเงิน	สถานะที่คาดหวัง
BCA	010800041187	JOHN CENA	Rp10.000 - Rp250.000.000	Completed
BCA	7095560835	JOHN CENA	Rp10.000 - Rp250.000.000	Processing

หมายเหตุสำคัญสำหรับการทดสอบ Sandbox:

จำนวนเงิน: ต้องอยู่ในช่วง Rp10.000 ถึง Rp250.000.000

BIFAST Disbursement API › Request Body

amount

integer · int32 · required

จำนวนเงินที่คุณต้องการส่ง

Default: 10000

referenceId

string · required

reference ID ที่ไม่ซ้ำกันเป็นตัวระบุที่ไม่ซ้ำกัน

Default: test-1

description

string · required

สตริงที่กำหนดเองแนบกับวัตถุ มักมีประโยชน์ในการแสดงให้ผู้ใช้เห็นว่าธุรกรรมมีไว้เพื่ออะไร ขีดจำกัดความยาวคำอธิบายคือ 1,000 ตัวอักษร

Default: test-disbursement-1

object · required

BIFAST Disbursement API › Responses

200

status

integer

Default: 0

message

string

id

string

type

string

object

error

POST/v2/payments/gs/bifast-disbursements

curl https://sandbox.onebrick.io/v2/payments/gs/bifast-disbursements \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'publicAccessToken: <api-key>' \
  --data '{
  "amount": 50000,
  "referenceId": "demo-{{var}}",
  "description": "test-l",
  "disbursementMethod": {
    "type": "bank_transfer",
    "bankAccountNo": "000123456789",
    "bankShortCode": "PERMATA",
    "bankAccountHolderName": "Example Customer"
  },
  "sender": {
    "name": "Example Customer",
    "identityType": "KTP",
    "identityNumber": "000123456789",
    "countryCode": "ID",
    "provinceCode": "75",
    "cityCode": "3205",
    "jobCode": "3",
    "address": "Example Address",
    "placeOfBirth": "Bali",
    "dateOfBirth": "1854-12-30"
  }
}'

Example Request Body

{
  "amount": 50000,
  "referenceId": "demo-{{var}}",
  "description": "test-l",
  "disbursementMethod": {
    "type": "bank_transfer",
    "bankAccountNo": "000123456789",
    "bankShortCode": "PERMATA",
    "bankAccountHolderName": "Example Customer"
  },
  "sender": {
    "name": "Example Customer",
    "identityType": "KTP",
    "identityNumber": "000123456789",
    "countryCode": "ID",
    "provinceCode": "75",
    "cityCode": "3205",
    "jobCode": "3",
    "address": "Example Address",
    "placeOfBirth": "Bali",
    "dateOfBirth": "1854-12-30"
  }
}

json

application/json

Example Responses

{
  "status": 200,
  "message": "We have received your request and are processing it, please check your callback URL for transaction status",
  "id": "example-disbursement-id",
  "type": "disbursement",
  "attributes": {
    "referenceId": "reference-id-from-your-system",
    "description": "reference-id-from-your-system",
    "amount": "10000",
    "feeAmount": "600",
    "status": "processing",
    "settlementStatus": "null",
    "createdAt": "2022-07-21T13:49:39.752+07:00",
    "disbursementMethod": {
      "type": "bank_transfer",
      "bankAccountNo": "000123456789",
      "bankShortCode": "BCA",
      "bankAccountHolderName": "Example Customer"
    },
    "sender": {
      "name": "Example Customer",
      "identityType": "KTP",
      "identityNumber": "000123456789",
      "countryCode": "ID",
      "provinceCode": "35",
      "cityCode": "1226",
      "jobCode": "89",
      "address": "Example Address",
      "placeOfBirth": "Jakarta",
      "dateOfBirth": "1998-04-23"
    }
  },
  "metaData": {
    "source": "API",
    "entity": "Payment"
  },
  "error": null
}

json

application/json

B2C Subaccount Balance

BIFAST Disbursement API

POST

https://sandbox.onebrick.io

/v2/payments/gs/bifast-disbursements

publicAccessToken (header)

การทดสอบในสภาพแวดล้อม Sandbox (โหมด Testing)

การเบิกจ่าย BI-Fast

รหัสย่อธนาคาร	เลขที่บัญชีธนาคาร	ชื่อเจ้าของบัญชีธนาคาร	จำนวนเงิน	สถานะที่คาดหวัง
BCA	010800041187	JOHN CENA	Rp10.000 - Rp250.000.000	Completed
BCA	7095560835	JOHN CENA	Rp10.000 - Rp250.000.000	Processing

หมายเหตุสำคัญสำหรับการทดสอบ Sandbox:

จำนวนเงิน: ต้องอยู่ในช่วง Rp10.000 ถึง Rp250.000.000

BIFAST Disbursement API › Request Body

amount

integer · int32 · required

จำนวนเงินที่คุณต้องการส่ง

Default: 10000

referenceId

string · required

reference ID ที่ไม่ซ้ำกันเป็นตัวระบุที่ไม่ซ้ำกัน

Default: test-1

description

string · required

Default: test-disbursement-1

object · required

BIFAST Disbursement API › Responses

200

status

integer

Default: 0

message

string

id

string

type

string

object

error