Crear usuarios

Registra usuarios Cobru desde tu producto, consulta categorías y completa verificación de correo y teléfono.

Esta página consolida documentación legacy de Cobru. Antes de usarla en producción, confirma con tu equipo de Cobru los campos obligatorios vigentes, los códigos de documento y el comportamiento exacto de verificación.

Endpoint de creación

POST https://dev.cobru.co/user/

Este endpoint permite registrar un nuevo usuario en la plataforma.

Campo `brand`

El campo brand corresponde al identificador de la marca bajo la cual se registra el usuario. Este valor permite asociar el registro a una empresa, aliado o producto específico.

{
  "brand": "MY_BRAND"
}

Campo `username`

Durante el registro, el campo username se envía con el número de teléfono del usuario u otro identificador si tu integración lo requiere.

{
  "username": "09906786442"
}

Una vez el usuario es creado correctamente, Cobru puede devolver el username con el prefijo de marca.

{
  "username": "MY_BRAND-09906786442"
}

El prefijo de marca en username aplica en la respuesta o en el valor final registrado del usuario, no en el payload inicial de creación.

Categorías y subcategorías

Antes de registrar el usuario, consulta las categorías y subcategorías que enviarás en el payload.

Obtener categorías

GET https://prod.cobru.co/category/

{
  "error": false,
  "message": [
    {
      "id": 99,
      "name": "Actividades De Organizaciones Y Entidades Extraterritoriales."
    },
    {
      "id": 98,
      "name": "Actividades No Diferenciadas De Los Hogares Individuales Como Productores De Bienes Y Servicios Para Uso Propio."
    },
    {
      "id": 97,
      "name": "Actividades De Los Hogares Individuales Como Empleadores De Personal Doméstico."
    },
    {
      "id": 96,
      "name": "Otras Actividades De Servicios Personales."
    }
  ]
}

Obtener subcategorías por categoría

GET https://prod.cobru.co/subcategory?category_id=66

{
  "error": false,
  "message": [
    {
      "id": 556,
      "name": "6630 Actividades De Administración De Fondos."
    },
    {
      "id": 555,
      "name": "663 Actividades De Administración De Fondos."
    },
    {
      "id": 554,
      "name": "6629 Evaluación De Riesgos Y Daños, Y Otras Actividades De Servicios Auxiliares."
    }
  ]
}

Reglas de categoría

category debe enviarse con el id de la categoría seleccionada.
subcategory debe enviarse con el id de la subcategoría correspondiente.
Las subcategorías deben consultarse usando el category_id seleccionado previamente.

Payload de ejemplo para persona natural

{
  "username": "09906786442",
  "first_name": "Test Testeo",
  "last_name": "Apellido Testeo",
  "email": "Teste@testecobruuuuu.com",
  "password": "12345678",
  "phone": "09906786442",
  "document_type": "0",
  "document_number": "11111122223",
  "country_code": "+57",
  "gender": 2,
  "date_birth": "2001-08-08",
  "type_person": 1,
  "date_expiration": "2019-08-08",
  "subcategory": 745,
  "profile_picture": "url_profile",
  "documents": [
    {
      "id": 2,
      "url": "url_documento"
    },
    {
      "id": 1,
      "url": "url_documento"
    },
    {
      "id": 3,
      "url": "url_documento"
    }
  ],
  "category": 99,
  "platform": "ios",
  "referal_code": "",
  "brand": "MY_BRAND"
}

Payload de ejemplo para persona jurídica

Para registrar una empresa, envía type_person: 2. En este caso, first_name contiene el nombre de la empresa, document_type se envía como "3" y document_number contiene el NIT. Los campos con sufijo _legal corresponden al representante legal.

{
  "username": "3001234567",
  "first_name": "ACME S.A.S.",
  "last_name": "",
  "email": "admin@acme.com",
  "password": "Password123*",
  "phone": "3001234567",
  "document_type": "3",
  "document_number": "901234567",
  "country_code": "+57",
  "gender": 1,
  "date_birth": "1990-05-15",
  "type_person": 2,
  "date_expiration": "2015-06-20",
  "gender_legal": 1,
  "subcategory": 12,
  "profile_picture": "https://...",
  "document_type_legal": "1",
  "document_number_legal": "1045672890",
  "name_legal": "Carlos Alberto",
  "last_name_legal": "Pérez Gómez",
  "date_birth_legal": "1990-05-15",
  "date_expiration_legal": "2015-06-20",
  "documents": [],
  "category": 4,
  "platform": "ios",
  "referal_code": "",
  "brand": "MY_BRAND"
}

Campos principales

Campo	Tipo	Descripción
`username`	string	Usuario enviado durante el registro, normalmente el número de teléfono.
`first_name`	string	Nombre del usuario o nombre de la empresa cuando `type_person` es `2`.
`last_name`	string	Apellido del usuario. Para persona jurídica puede enviarse vacío.
`email`	string	Correo electrónico del usuario.
`password`	string	Contraseña del usuario.
`phone`	string	Número de teléfono.
`document_type`	string	Tipo de documento. Para persona jurídica se envía `"3"`.
`document_number`	string	Número de documento. Para persona jurídica corresponde al NIT.
`country_code`	string	Indicativo del país.
`gender`	number	Género del usuario.
`date_birth`	string	Fecha de nacimiento.
`type_person`	number	Tipo de persona: `1` para persona natural, `2` para persona jurídica.
`date_expiration`	string	Fecha de expedición o vencimiento según la lógica del sistema.
`gender_legal`	number	Género del representante legal para persona jurídica.
`subcategory`	number	ID de la subcategoría seleccionada.
`profile_picture`	string	URL de la foto de perfil.
`document_type_legal`	string	Tipo de documento del representante legal.
`document_number_legal`	string	Número de documento del representante legal.
`name_legal`	string	Nombres del representante legal.
`last_name_legal`	string	Apellidos del representante legal.
`date_birth_legal`	string	Fecha de nacimiento del representante legal.
`date_expiration_legal`	string	Fecha de expedición o vencimiento del documento del representante legal.
`documents`	array	Arreglo de documentos del usuario.
`category`	number	ID de la categoría seleccionada.
`platform`	string	Plataforma desde la cual se registra el usuario.
`referal_code`	string	Código de referido, si aplica.
`brand`	string	Identificador de la marca asociada al registro.

Valores de persona y género

Usa estos valores numéricos para type_person, gender y gender_legal.

Campo	Valor	Significado
`type_person`	`1`	Persona natural.
`type_person`	`2`	Persona jurídica.
`gender` / `gender_legal`	`0`	Ninguno.
`gender` / `gender_legal`	`1`	Femenino.
`gender` / `gender_legal`	`2`	Masculino.

Estructura de `documents`

El campo documents recibe un arreglo de objetos correspondiente a los documentos del usuario. Cada objeto debe incluir:

id: identificador del tipo de documento.
url: URL del documento cargado.

[
  {
    "id": 2,
    "url": "url_documento"
  },
  {
    "id": 1,
    "url": "url_documento"
  }
]

Respuesta esperada

Si toda la información es válida y el proceso se completa correctamente, el usuario se crea con respuesta 201.

{
  "error": false,
  "message": {
    "email": "Teste@testecobruuuuu.com",
    "first_name": "Edeiver Testeo",
    "gender": null,
    "gender_legal": null,
    "id": 2093,
    "last_name": "Apellido Testeo",
    "username": "MY_BRAND-09906786442"
  },
  "status": 201
}

Confirmación de correo y teléfono

Para enviar códigos de confirmación, llama primero el servicio de solicitud de confirmación.

POST http://dev.cobru.co/request_confirmation/
Content-Type: application/json

Campo	Tipo	Descripción
`phone`	boolean	Indica si el código será enviado al teléfono.
`email`	boolean	Indica si el código será enviado al correo electrónico.

Luego confirma cada canal con una llamada separada.

Confirmar correo electrónico

POST http://dev.cobru.co/verify_email/
Content-Type: application/json

Campo	Tipo	Descripción
`code`	integer	Código recibido en el correo electrónico.

Confirmar teléfono

POST http://dev.cobru.co/verify_phone/
Content-Type: application/json

Campo	Tipo	Descripción
`code`	integer	Código recibido en el teléfono.

Notas importantes

documents debe enviarse como un arreglo de objetos.
En el registro inicial de persona jurídica, documents puede enviarse como arreglo vacío; la validación de documentos se maneja después desde la tarjeta del Home.
Cada documento debe enviarse mediante una URL válida en el campo url.
profile_picture también debe enviarse como una URL válida.
brand debe contener el identificador de la marca asociada al registro.
El username del payload inicial se envía sin el prefijo de marca.
Cobru puede retornar o almacenar el username final con el prefijo de la marca después del registro.
Las categorías y subcategorías deben consultarse previamente para enviar los IDs correctos.
Para persona jurídica, category y subcategory vienen de los selectores de actividad o categoría.

Usar el usuario en envíos

Después del registro y la verificación, puedes usar el usuario en flujos de envío de dinero:

El usuario que envía dinero debe tener correo electrónico y celular en estado verificado.

Crear usuarios

On this page