KYC Status Webhook

Webhook implementation for KYC statuses

In order for partners to notify Fuap of status updates during workflows such as KYC, Loan Statuses, and Repayment statuses, Fuap will provide the API endpoint listed below. This endpoint will be used for all status updates.

Fuap KYC webhook endpoint

https://api-sandbox.fuap.ai/api/webhooks/status/kyc

Headers

Name	Value
API Key	Bearer <token>
API Secret	Bearer <token>

Body

Name	Type	Description
referenceID	string	SubmissionID
Event Type	string	KYC
status	string	COMPLETED | FAILED | IN_REVIEW | UPDATE_REQUIRED
metadata	json

Response

200

{
    "message": "success"
}

400

{
  "error": "Invalid request"
}

KYC event type statuses

COMPLETED	kyc verified	null
FAILED	kyc failed	{“failureReason”: string}
IN_REVIEW	kyc submission is being review	null
UPDATE_REQUIRED	kyc requires additional info	{“requiredFields”: [string] }

Example Body:

{
 "referenceId": string,   (LoanID for loan product status & submissionId for KYC statuses)
 "eventType": string,    (Personal_Loan, Home_Loan, Credit_Card, KYC)
 "status": string,
 "metadata": json,
}

Example Response:

{
    "message": "success"
}