Webhook

Check contract

Fintwin calls the enterprise checkCust endpoint when registration needs the contract confirmed.

The enterprise must build this endpoint. Fintwin is the caller. The portal describes the contract only and has no Try.

When it fires

Before the debit mandate is completed at the bank.

Endpoint requirements

Accept HTTPS POST with Authorization and a signature. Verify the signature and return JSON. A repeated event must not create a duplicate record.

Body Fintwin sends

Fields	Description
`com_cd`Required	Enterprise code.
`bank_cd`Required	Bank code.
`contractId`Required	Contract id.
`cusType`Optional	CA_NHAN or DOANH_NGHIEP.
`nationalId`Optional	National id.
`phoneNumber`Optional	Phone number.
`registrationNumber`Optional	Enterprise registration number.

Body the enterprise returns

Fields	Description
`errorCode`Required	0000 when the contract is valid.
`errorDesc`Required	Short description.
`contractNm`Optional	Contract name.
`contractValid`Optional	Validity date.
`nationalId`Optional	National id to match.

Request example

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

Response example

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