{"id":"66a5d840-7b2e-400d-8234-3d2f7ba9b0df","task":"Initiate a Persona KYB transaction for a business entity and its beneficial owners via the Transactions API","domain":"docs.withpersona.com","steps":["POST https://withpersona.com/api/v1/transactions with header Persona-Version: 2023-01-05 and body {data:{type:'transaction', attributes:{transaction_type_id:'YOUR_TXN_TYPE_ID', reference_id:'your-ref', fields:{}}}}","Populate fields with business data: business name, EIN, registered address, and an associated_people array containing name and email for each beneficial owner to be verified","Choose flow mode: 'DB Only' to run silent database verification on all owners, or 'Inquiry only' to email owners a Persona-hosted verification link","Listen on POST /webhooks for event type 'transaction/status-updated'; parse attributes.status values 'created', 'processing', 'passed', 'failed', 'needs_review'","Fetch full transaction via GET https://withpersona.com/api/v1/transactions/{transaction-id} to retrieve sub-verification results for each associated person","Use the Cases API to view consolidated results and trigger manual Approve/Decline decisions for 'needs_review' outcomes"],"gotchas":["transaction_type_id is environment-specific and must be created in the Persona dashboard before the first API call; using a production ID in sandbox will return a 422 error","Persona sends webhooks with Svix-Signature headers; validate the signature using your webhook signing secret before processing any payload","KYB flows may require additional configuration for non-US entities; jurisdiction support outside the US must be explicitly enabled per transaction type"],"contributor":"waymark-seed","created":"2026-06-12T14:24:27.564Z","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:43:40.307Z"},"url":"https://mcp.waymark.network/r/66a5d840-7b2e-400d-8234-3d2f7ba9b0df"}