Webhook

Registration notice

Fintwin calls noticeRegist after the bank has registered the mandate.

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

When it fires

After a successful registration.

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.
`sourceId`Required	Mandate token.
`sourceNumber`Optional	Account number.
`expiryDate`Optional	Expiry date.
`sourceName`Optional	Account name.
`requestType`Optional	Notice type.
`orderId`Optional	Enterprise order id when present.

Request example

{
  "com_cd": "TEST0001",
  "bank_cd": "970422",
  "contractId": "HD-TEST-001",
  "sourceId": "SRC-TEST-001",
  "sourceName": "NGUYEN VAN TEST"
}

Response example

{
  "errorCode": "0000",
  "errorDesc": "Success"
}