Webhook

Thông báo hủy

Fintwin gọi noticeCancel sau khi ủy quyền đã được hủy tại ngân hàng.

Phía doanh nghiệp cần xây dựng endpoint này. Fintwin là bên gọi. Cổng chỉ mô tả hợp đồng, không có Try.

Khi nào gọi

Sau hủy thành công.

Yêu cầu với endpoint

Nhận POST HTTPS kèm Authorization và chữ ký. Xác thực chữ ký rồi trả JSON. Nhận lại cùng sự kiện không tạo bản ghi trùng.

Body Fintwin gửi

TrườngMô tả
com_cdBắt buộcMã doanh nghiệp.
bank_cdBắt buộcMã ngân hàng.
contractIdBắt buộcMã hợp đồng.
sourceIdBắt buộcToken ủy quyền.
sourceNumberTùy chọnSố tài khoản.
expiryDateTùy chọnNgày hết hạn.
sourceNameTùy chọnTên chủ tài khoản.
requestTypeTùy chọnLoại thông báo.

Body doanh nghiệp trả

TrườngMô tả
errorCodeBắt buộc0000 khi đã ghi nhận.
errorDescBắt buộcMô tả.
Ví dụ request
{
  "com_cd": "TEST0001",
  "bank_cd": "970422",
  "contractId": "HD-TEST-001",
  "sourceId": "SRC-TEST-001"
}
Ví dụ response
{
  "errorCode": "0000",
  "errorDesc": "Success"
}