Events

Event Name	Status	Description
`kyb.pending`	PENDING	KYB application submitted, under review
`kyb.additional_info_required`	PENDING_RESPONSE	Additional information or documents required
`kyb.completed`	APPROVED	KYB verification approved
`kyb.rejected`	REJECTED	KYB verification rejected
`fiat_account.activated`	ACTIVATED	Fiat account activated and ready for use

kyb.pending

Triggered when a KYB application is submitted and is under review.

Payload

{
  "event_name": "kyb.pending",
  "resource": {
    "type": "kyb_applicant",
    "id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "data": {
    "customer_id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PENDING"
  }
}

kyb.additional_info_required

Triggered when the KYB review requires additional information or documents from the applicant. This may include issues with the company information or associated persons.

Payload

{
  "event_name": "kyb.additional_info_required",
  "resource": {
    "type": "kyb_applicant",
    "id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "data": {
    "customer_id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PENDING_RESPONSE",
    "company_issues": {
      "company_name": "Acme Corporation",
      "reject_labels": ["UNSATISFACTORY_PHOTOS", "DOCUMENT_MISSING"]
    },
    "associated_person_issues": [
      {
        "associated_person_id": "ap_xyz789",
        "name": "John Doe",
        "reject_labels": ["ID_EXPIRED", "SELFIE_MISMATCH"]
      }
    ]
  }
}

Fields

Field	Type	Description
`customer_id`	string	The customer ID
`status`	string	Always `PENDING_RESPONSE` for this event
`company_issues`	object \| null	Issues with the company applicant (if any)
`company_issues.company_name`	string	Company name
`company_issues.reject_labels`	array	List of issue labels
`associated_person_issues`	array	List of issues with associated persons
`associated_person_issues[].associated_person_id`	string	Associated person ID
`associated_person_issues[].name`	string \| null	Associated person's full name
`associated_person_issues[].reject_labels`	array	List of issue labels

Common Reject Labels

Label	Description
`UNSATISFACTORY_PHOTOS`	Photo quality is insufficient
`DOCUMENT_MISSING`	Required document is missing
`ID_EXPIRED`	ID document has expired
`SELFIE_MISMATCH`	Selfie does not match ID photo
`DOCUMENT_DAMAGED`	Document is damaged or unreadable

kyb.completed

Triggered when KYB verification is successfully completed and approved.

Payload

{
  "event_name": "kyb.completed",
  "resource": {
    "type": "kyb_applicant",
    "id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "data": {
    "customer_id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "APPROVED",
    "company_name": "Acme Corporation"
  }
}

Fields

Field	Type	Description
`customer_id`	string	The customer ID
`status`	string	Always `APPROVED` for this event
`company_name`	string	The verified company name

kyb.rejected

Triggered when KYB verification is rejected.

Payload

{
  "event_name": "kyb.rejected",
  "resource": {
    "type": "kyb_applicant",
    "id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "data": {
    "customer_id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "REJECTED"
  }
}

fiat_account.activated

Triggered when a customer's fiat account is activated and ready for deposits and withdrawals.

Payload

{
  "event_name": "fiat_account.activated",
  "resource": {
    "type": "fiat_account",
    "id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "data": {
    "customer_id": "cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "ACTIVATED"
  }
}

Fields

Field	Type	Description
`customer_id`	string	The customer ID
`status`	string	Always `ACTIVATED` for this event