A business customer is a company record belonging to your account, identified by company_name, registration_number, and country. Create one before you generate a payment link for that company.
Verification is a separate, optional step. Nothing in this section requires it and the payment endpoints do not check it. Reach for KYB Verification when your compliance policy calls for verifying a business, and the KYB Verification Guide for the end-to-end flow.
Why these paths start with
/kyb: these endpoints live under/api/v1/kyb/businessesfor historical reasons, from when creating a business and verifying it were a single flow. The prefix carries no meaning today - a business created here is a plain company record, verified or not.
In this section
| Endpoint | What it does |
|---|---|
POST /kyb/businesses | Create a business, or return the existing one with the same registration number and country |
GET /kyb/businesses | List businesses with their verification state, paginated and filterable |
PATCH /kyb/businesses/{business_id} | Update name, legal address, tax id, or contact email |
PATCH /kyb/businesses/{business_id}/verification-mode | Switch between managed KYB and external attestation |
POST /kyb/businesses/{business_id}/activate | Reactivate a deactivated business |
POST /kyb/businesses/{business_id}/deactivate | Soft-delete a business (requires a reason, OWNER only) |