Webhook

Kiểm tra hợp đồng

Fintwin gọi endpoint checkCust của doanh nghiệp khi luồng đăng ký cần xác nhận hợp đồng còn hiệu lực.

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

Trước khi hoàn tất đăng ký ủy quyền tại ngân hà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ường	Mô tả
`com_cd`Bắt buộc	Mã doanh nghiệp.
`bank_cd`Bắt buộc	Mã ngân hàng.
`contractId`Bắt buộc	Mã hợp đồng.
`cusType`Tùy chọn	CA_NHAN hoặc DOANH_NGHIEP.
`nationalId`Tùy chọn	Số định danh.
`phoneNumber`Tùy chọn	Số điện thoại.
`registrationNumber`Tùy chọn	Số đăng ký doanh nghiệp.

Body doanh nghiệp trả

Trường	Mô tả
`errorCode`Bắt buộc	0000 khi hợp đồng hợp lệ.
`errorDesc`Bắt buộc	Mô tả ngắn.
`contractNm`Tùy chọn	Tên hợp đồng.
`contractValid`Tùy chọn	Ngày hiệu lực.
`nationalId`Tùy chọn	Số định danh đối chiếu.

Ví dụ request

{
  "com_cd": "TEST0001",
  "bank_cd": "970422",
  "contractId": "HD-TEST-001",
  "cusType": "CA_NHAN",
  "nationalId": "000000000000",
  "phoneNumber": "0900000000"
}

Ví dụ response

{
  "errorCode": "0000",
  "errorDesc": "Success",
  "contractNm": "HOP DONG TEST",
  "contractValid": "20271231"
}