Webhook Reference

Third Party Customer Status Updated Event

Sent when the status of a third party customer changes.

Once you have subscribed to the “THIRD PARTY CUSTOMER STATUS” event type, Redpin will call your designated API endpoint with the payload described below when there is an update to one of your third party customer’s statuses.

Example Payloads:

REJECTED

1{
2  "event_id": "1",
3  "event_timestamp": "2025-01-01T00:00:00Z",
4  "customer_id": "0201001008132685",
5  "client_customer_ref": "CUST_001",
6  "status": "REJECTED",
7  "data": {
8    "reasons": [
9      {
10        "reason": "Compliance check failed due to validation or regulatory issues",
11        "code": "COMPLIANCE_CHECK_FAILED"
12      }
13    ]
14  }
15}

APPROVED

1{
2  "event_id": "3",
3  "event_timestamp": "2025-01-01T00:00:00Z",
4  "customer_id": "0201001008132685",
5  "client_customer_ref": "CUST_001",
6  "status": "APPROVED"
7}

Payload

The payload of this webhook request is an object.
event_idstringRequired
Unique identifier for the event
event_timestampstringRequired

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

customer_idstringRequired
Unique identifier for the customer
client_customer_refstringRequired
The unique reference identifier of the third party client
statusenumRequired
Status of the third party customer
Allowed values:
dataobjectOptional

The data object is optional.
It is only present when the status is REJECTED. It contains an array of reasons for the rejection.
If the status is APPROVED, the data object is not present.

Response

200
any
Return a 200 status to indicate that the data was received successfully.