Webhook thông báo nạp tiền

Quy trình

• Baokim gọi API webhook của MERCHANT để gửi thông báo giao dịch nạp tiền

Thông tin API

URL: Merchant cung cấp

Method: POST

• Header:

  • Content-Type: Application/json

  • Signature: $signature

Baokim gửi lên Đối tác (Webhook)

Bảng tham số chính

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	request_id	String(100)	✅	Id duy nhất ứng với mỗi Request từ Baokim gửi sang MERCHANT.
2	request_time	String(20)	✅	Thời gian gửi Request. Format: YYYY-MM-DD H:i:s
3	master_merchant_code	String(50)	✅	Mã định danh duy nhất cho MASTER MERCHANT
4	sub_merchant_code	String(50)	✅	Mã định danh duy nhất cho SUB MERCHANT
5	operation	String(50)	✅	GD nạp tiền qua VA: DEPOSIT_TRANS
6	transaction	Object	✅	Thông tin giao dịch
7	va_info	Object	✅	Thông tin VA nạp tiền của Merchant

Thông tin transaction

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	id	Number	✅	Mã giao dịch của Baokim
2	amount	Number	✅	Số tiền merchant thực nhận
3	opening_balance	Number	✅	Số dư trước giao dịch
4	balance	Number	✅	Số dư sau giao dịch
5	description	String(50)	✅	Nội dung giao dịch
6	status	Number	✅	Trạng thái giao dịch
7	completed_at	DateTime	✅	Thời gian hoàn thành giao dịch
8	created_at	DateTime	✅	Thời gian tạo giao dịch
9	updated_at	DateTime	✅	Thời gian cập nhật giao dịch

Thông tin va_info

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	bank_name	String	✅	Tên ngân hàng VA
2	bank_branch	String	❌	Chi nhánh
3	acc_no	String	✅	Số tài khoản VA
4	acc_name	String	✅	Tên tài khoản VA
5	qr_string	String	✅	Chuỗi QR
6	qr_path	String	✅	Đường dẫn ảnh QR

Ví dụ Request

{
  "request_id": "MERCHANT050015588AXE012",
  "request_time": "2026-05-21 14:41:00",
  "master_merchant_code": "MASTERMERCHANTCODE",
  "sub_merchant_code": "SUBMERCHANTCODE",
  "operation": "DEPOSIT_TRANS",
  "transaction": {
    "id": 5567261,
    "amount": 200000,
    "opening_balance": 100000,
    "balance": 300000,
    "description": "NGUYEN VAN A chuyen tien",
    "status": 1,
    "completed_at": "2026-05-21 14:41:00",
    "created_at": "2026-05-21 14:41:00",
    "updated_at": "2026-05-21 14:41:00"
  },
  "va_info": {
    "bank_name": "Ngân hàng TMCP Ngoại Thương Việt Nam (Vietcombank)",
    "bank_branch": "Chi nhánh Hà Nội",
    "acc_no": "01234567890123",
    "acc_name": "BAOKIM NGUYEN VAN A",
    "qr_string": "00020101021238550010A0000007270123000697040300000000000020386304C3A4",
    "qr_path": "https://sandbox.baokim.vn/qr/BK1234567890.png"
  }
}

Đối tác phản hồi Webhook

Bảng tham số chính

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	code	String(4)	✅	code trả về cho phía Baokim, bảo đảm phía MERCHANT đã nhận được
2	message	String(20)	✅	Message trả về cho phía Baokim
3	data	Object	❌	Dữ liệu Merchant trả về cho Baokim nếu có

Ví dụ Response

{
  "code": 100,
  "message": "Success",
  "data": null
}