Profile - Decision Callback

Endpoint Configuration: callback_url

Unique Feature: Unlike user profiles, business profiles DO support decision callbacks.

The decision callback is triggered when an onboarding session linked to the business profile completes with a final decision.

When It's Triggered

• Onboarding verification session linked to business profile reaches terminal state
• Contains full business profile state after decision

Payload Structure

The payload is a BusinessProfileEventEnvelope that includes all fields from BusinessVerificationResultPayload representing the complete profile state.

Payload:

{
  "business_profile_id": "bp_xyz123",
  "business_profile_event_type": "RUN_BUSINESS_VERIFICATION",
  "client_reference_id": "our_business_id_456",
  "client_reference_data": {
    "account_manager": "[email protected]",
    "business_tier": "enterprise"
  },
  
  // Full BusinessVerificationResultPayload embedded
  "verification_session_id": "bvs_abc123",
  "template_id": "tmpl_kyb_enterprise",
  "aiprise_summary": {
    "decision": "APPROVED",
    "status": "COMPLETED"
  },
  "business_input": { /* ... */ },
  "business_info": { /* ... */ },
  "registration_info": { /* ... */ },
  "aml_info": { /* ... */ },
  "related_persons": [ /* ... */ ],
  "related_companies": [ /* ... */ ]
  // ... complete business profile state
}

Use Cases:

• Use when you need the final decision in one consolidated callback
• Simpler integration for straightforward KYB flows
• Combine with events_callback_url for comprehensive tracking