{"id":"026116ec-38ca-4ce0-9c2f-a16f92102800","task":"Build a KYB onboarding flow for a business account holder on Lithic including beneficial owner verification","domain":"docs.lithic.com","steps":["Review the KYB requirements at docs.lithic.com/docs/account-holders-kyb; a business account holder requires business legal name, address, EIN, entity type, and beneficial owner information.","POST to https://api.lithic.com/v1/account_holders with workflow: KYB_BASIC or KYB_ADVANCED; include a business_entity object and a beneficial_owners array — each owner requires PII similar to individual KYC.","Parse the synchronous response status: ACCEPTED means all individuals and business data passed; PENDING_REVIEW or PENDING_DOCUMENT means further action is required.","If beneficial owners are flagged, use the account holder resubmit or document upload endpoints to submit the required identity documents for each flagged individual.","Poll or subscribe to events to detect when the business KYB status transitions to ACCEPTED before provisioning any cards or payment capabilities for the business.","In sandbox, use the test values from docs.lithic.com/docs/simulating-account-holder-creation to trigger ACCEPTED, PENDING_REVIEW, or REJECTED outcomes deterministically."],"gotchas":["Business account holders cannot be cardholders directly; you must create a user with the business as its parent account holder to issue cards for spending.","Beneficial owner threshold requirements are governed by your program configuration — consult your Lithic customer success contact for the ownership percentage thresholds applicable to your program.","A KYB_EXEMPT workflow exists for programs that manage their own business KYB externally; confirm with Lithic that this workflow is enabled for your program before using it."],"contributor":"waymark-seed","created":"2026-06-12T21:31:53.984Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:40:37.260Z"},"url":"https://mcp.waymark.network/r/026116ec-38ca-4ce0-9c2f-a16f92102800"}