Skip to main content
WEBHOOK
customer.rfi
{
  "event": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "event_reference_id": "cust-uuid-1234",
    "type": "customer.rfi",
    "created_at": "2026-04-04T10:00:00.000000Z",
    "sandbox_mode": false
  },
  "data": {
    "customer_id": "cust-uuid-1234",
    "request_for_information": [
      {
        "section": "proof_of_identity",
        "categories": [
          {
            "document_type": "GOVERNMENT_ID",
            "fields": [
              {
                "field_name": "files",
                "data_type": "URI",
                "status": "EXPIRED",
                "reason": "Document has expired",
                "side": "FRONT"
              },
              {
                "field_name": "files",
                "data_type": "URI",
                "status": "INVALID",
                "reason": "Back side damaged",
                "side": "BACK"
              },
              {
                "field_name": "issue_date",
                "data_type": "DATE",
                "status": "MISSING",
                "reason": null
              },
              {
                "field_name": "expiry_date",
                "data_type": "DATE",
                "status": "MISSING",
                "reason": null
              },
              {
                "field_name": "text",
                "data_type": "TEXT",
                "status": "INVALID",
                "reason": "Name mismatch"
              }
            ]
          }
        ]
      },
      {
        "section": "proof_of_address",
        "categories": [
          {
            "document_type": "PROOF_OF_ADDRESS",
            "fields": [
              {
                "field_name": "files",
                "data_type": "URI",
                "status": "MISSING",
                "reason": null
              }
            ]
          }
        ]
      },
      {
        "section": "tos_policies_value",
        "categories": [
          {
            "document_type": "TOS",
            "fields": [
              {
                "field_name": "tos_policies_value",
                "data_type": "TEXT",
                "status": "MISSING",
                "reason": null
              }
            ]
          }
        ]
      }
    ]
  }
}

​
When This Fires

This webhook fires when compliance flags one or more documents or fields as missing, expired, or invalid. The customer status will be set to ACTION_REQUIRED.
An RFI can also be triggered after a customer is already APPROVED. In that case the customer status remains unchanged. Only the rrequest_for_information object in the payload will contain data and this webhook will be received.

​
RFI Available Scope

  • CUSTOMER — The issue is with the customer’s own documents or data
  • ASSOCIATED PARTY — The issue is with a specific associated party (identified by associated_party_id)

​
Field Status Values

  • MISSING — Document or field was not provided
  • EXPIRED — Document has passed its expiry date
  • INVALID — Document or field value does not meet requirements (see reason)

​
Section Values by Customer Type

Customer TypeSections
Individualproof_of_identity, proof_of_address, tos_policies_value
Business V1company_details, ownership_structure, legal_presence
Business V2formation_documents, ownership_documents, supporting_documents
Associated Party (V1)proof_of_identity, proof_of_address
Associated Party (V2)identifying_documents, tax_info, address_documents
All webhook requests include HMAC signatures for verification.

Body

application/json
​
event
object
​
data
object

Response

200

Webhook received successfully