Third Party Customer Status Updated Event
Sent when a third party customer's compliance status changes to `APPROVED` or `REJECTED`. Subscribe to the `THIRD PARTY CUSTOMER STATUS` event type to receive these updates.
The `data` object contains `customer_id`, `client_customer_ref`, and `status`. When the status is `REJECTED`, a `reasons` array is included with machine-readable codes and human-readable descriptions.
**Example payloads:**
<Accordion title="REJECTED">
```json
{
"event_id": "1",
"event_type": "THIRD PARTY CUSTOMER STATUS",
"version": "v1.0.0",
"event_timestamp": "2025-01-01T00:00:00Z",
"data": {
"customer_id": "0201001008132685",
"client_customer_ref": "CUST_001",
"status": "REJECTED",
"reasons": [
{
"reason": "Compliance check failed due to validation or regulatory issues",
"code": "COMPLIANCE_CHECK_FAILED"
}
]
}
}
```
</Accordion>
<Accordion title="APPROVED">
```json
{
"event_id": "3",
"event_type": "THIRD PARTY CUSTOMER STATUS",
"version": "v1.0.0",
"event_timestamp": "2025-01-01T00:00:00Z",
"data": {
"customer_id": "0201001008132685",
"client_customer_ref": "CUST_001",
"status": "APPROVED"
}
}
```
</Accordion>
Payload
The payload of this webhook request is an object.
event_id
Unique identifier for the event
event_type
Type of webhook event. Always "THIRD PARTY CUSTOMER STATUS" for third party customer status events.
Allowed values:
version
Payload version. Currently "v1.0.0". This enables controlled evolution of the webhook contract.
event_timestamp
Timestamp of the event in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
data
Business data for the third party customer status event. Contains customer and status information.
The reasons field is only present when the status is REJECTED.
Response
200
Webhook received successfully
400
Invalid payload
