Clients - ON RAMP by Mesadepagos

El modulo Clients permite registrar personas o empresas vinculadas al business autenticado, iniciar su onboarding en Persona y consultar su estado.

Endpoints

Nombre	Metodo	Ruta
Crear cliente	`POST`	`/v2/business-clients`
Listar clientes	`GET`	`/v2/business-clients`

Ambos endpoints requieren un token JWT enviado como Bearer token.

Crear cliente

POST /v2/business-clients

Request

Campo	Tipo	Requerido	Descripción
`name`	`string`	Sí	Nombre de la persona o empresa.
`email`	`string`	Sí	Correo electrónico válido del cliente.
`type`	`string`	Sí	`individual` o `company`.
`country`	`string`	Sí	Código de país de 2 a 4 caracteres.
`settlementNetwork`	`string`	No	`Ethereum` o `Polygon`. Por defecto, `Polygon`.
`settlementAsset`	`string`	No	`USDC` o `USDT`. Por defecto, `USDC`.

{
  "name": "Acme Bolivia",
  "email": "cliente@example.com",
  "type": "company",
  "country": "BO",
  "settlementNetwork": "Polygon",
  "settlementAsset": "USDC"
}

Response

{
  "clientId": "550e8400-e29b-41d4-a716-446655440000",
  "clientLink": "https://withpersona.com/verify/example"
}

clientLink es el enlace de un solo uso que el cliente debe abrir para completar su onboarding en Persona. La red y el activo elegidos se usan para liquidar los cobros de sus cuentas virtuales. La API valida que la combinación esté disponible al crear el cliente y responde 400 si no lo está. Estos campos no se devuelven en la respuesta de creación. Consulta el flujo de cuentas virtuales para solicitar las verificaciones por moneda y registrar la dirección de retiro.

Listar clientes

GET /v2/business-clients

Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Bolivia",
    "type": "company",
    "status": "Active",
    "country": "BO",
    "email": "cliente@example.com",
    "externalClientId": null
  }
]

Los estados que actualmente devuelve la API son Pending, Onboarding, Active, Rejected y Suspended. externalClientId es null mientras el cliente todavia no tenga una relacion con el proveedor externo.

​Endpoints

​Crear cliente

​Request

​Response

​Listar clientes

​Response

Endpoints

Crear cliente

Request

Response

Listar clientes

Response