FintwinDeveloper Portal
Ctrl K
Đăng nhập

Webhook

Thông báo đăng ký

Fintwin gọi noticeRegist sau khi ngân hàng đã đăng ký ủy quyền thành cô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 đăng ký 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.
orderIdTùy chọnMã đơn phía doanh nghiệp nếu có.

Body doanh nghiệp trả

TrườngMô tả
errorCodeBắt buộc0000 khi đã ghi nhận.
errorDescBắt buộcMô tả.
orderIdTùy chọnMã đơn phản hồi.
Ví dụ request
{
  "com_cd": "TEST0001",
  "bank_cd": "970422",
  "contractId": "HD-TEST-001",
  "sourceId": "SRC-TEST-001",
  "sourceName": "NGUYEN VAN TEST"
}
Ví dụ response
{
  "errorCode": "0000",
  "errorDesc": "Success"
}