Skip to navigation
Webhook ReferenceThird Party Customers

Third Party Customer Status Updated Event

Sent when a third party customer’s compliance status changes to APPROVED, REJECTED, or PENDING. 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:

{
  "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"
      }
    ]
  }
}
{
  "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"
  }
}
{
  "event_id": "2",
  "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": "PENDING"
  }
}

Payload

The payload of this webhook request is an object.
event_idstringRequired
Unique identifier for the event
event_typeenumRequired
Type of webhook event. Always "THIRD PARTY CUSTOMER STATUS" for third party customer status events.
Allowed values:
versionstringRequired
Payload version. Currently "v1.0.0". This enables controlled evolution of the webhook contract.
event_timestampdatetimeRequired

Timestamp of the event in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

dataobjectRequired

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