Personas y empresas

CBPay tiene dos tipos de cuenta — persona (type: "person") y empresa (type: "company") — que usan la misma API con los mismos endpoints. Esta página reúne TODAS las diferencias en un solo lugar, para que nunca tengas que adivinar cuál aplica. El tipo se define al crear la cuenta y no cambia. Lo ves en GET /v1/me → type.

Tabla completa de diferencias

Capacidad	Persona	Empresa
Saldo USDT, payouts, payins, transferencias, banking, cartola	Igual	Igual
Wallets de depósito (crypto) por red+activo	1 (nacen con la cuenta; solo reciben)	1 (nacen con la cuenta; solo reciben)
Wallets segregadas (saldo propio on-chain)	1 por red+activo	Ilimitadas (usa `label` para distinguirlas)
Tarjetas	1 virtual + 1 física, solo para sí misma	Ilimitadas, para la empresa o para personas designadas (empleados)
Miembros con login (`POST /v1/members`)	No (`403 company_only`)	Sí — roles `owner` / `operator` / `viewer`
Verificación de identidad (`/v1/me/verification`)	Onboarding KYC (wizard con documentos + prueba de vida)	Onboarding KYB (wizard con documentos societarios)
Verificar a terceros (`/v1/{kyc,kyb}/links` y submissions)	No (`403 company_account_required`)	Sí — links hosteados o datos por API, cobra `kyc_verification`/`kyb_verification`
AML screening (`POST /v1/aml/screenings`)	Screening de persona (`customer.person`), cobra `compliance_person`	Screening de empresa (`customer.company`), cobra `compliance_company`
Titular de tarjetas (primera emisión)	Datos personales + documentos de identidad	Datos societarios + documentos corporativos (o los de la persona designada)
Registro	`type: "person"`	`type: "company"` (+ `tax_id` recomendado)

Todo lo demás — autenticación, idempotencia, webhooks, estados, errores, límites de gasto por tarjeta, servicios habilitados — funciona idéntico.

Cómo se ve en la práctica

Cuenta persona
Cuenta empresa

Registro: POST /v1/auth/register con type: "person" (o la crea tu operador).
Verificación: pide tu link KYC con POST /v1/me/verification/link y completa el wizard — hasta aprobar solo puedes fondear (guía).
Crypto: tus wallets de depósito nacen con la cuenta (una por red+activo; solo reciben). ¿Necesitas una wallet con saldo propio? Puedes tener 1 wallet segregada por red+activo.
Tarjetas: hasta 1 virtual + 1 física; la primera emisión lleva tus datos y documentos — guía.
Sin miembros: tu login y tus API keys operan la cuenta.

Registro: type: "company", idealmente con tax_id.
Verificación: pide tu link KYB con POST /v1/me/verification/link y completa el wizard con los datos societarios; aprobada, puedes además verificar a tus propios clientes (guía).
Crypto: tus wallets de depósito nacen con la cuenta (una por red+activo; solo reciben). Para saldos separados on-chain crea wallets segregadas ilimitadas (una por sucursal, por producto, por proveedor…), con label descriptivo.
Tarjetas: ilimitadas — corporativas (titular = la empresa, con documentos societarios en la primera) o para empleados (persona designada con sus datos en cada designación) — guía.
Miembros: agrega usuarios con login propio y permisos (owner/operator/viewer) — guía.

Errores que delatan el tipo de cuenta

`error`	Qué significa
`403 company_only`	Intentaste una función de empresa (miembros) desde una cuenta persona
`422 wallet_limit_reached`	La cuenta ya tiene su wallet de esa combinación (depósito: todos; segregada: personas)
`409 card_limit_reached`	Una persona intentó su segunda tarjeta del mismo tipo

¿Tu operación creció de persona a empresa? El tipo de cuenta no se cambia por API: pide a tu administrador CBPay crear la cuenta empresa y migrar el saldo con una transferencia interna (gratis e instantánea).

Comenzar

Conceptos

Flujos de integración

Productos

Integración

Recursos

Personas y empresas

Tabla completa de diferencias

Cómo se ve en la práctica

Errores que delatan el tipo de cuenta

​Tabla completa de diferencias

​Cómo se ve en la práctica

​Errores que delatan el tipo de cuenta

Tabla completa de diferencias

Cómo se ve en la práctica

Errores que delatan el tipo de cuenta