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

{
  "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"
}

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.
`last_name`	string	Apellido del usuario.
`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.
`document_number`	string	Número de documento.
`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.
`date_expiration`	string	Fecha de expedición o vencimiento según la lógica del sistema.
`subcategory`	number	ID de la subcategoría seleccionada.
`profile_picture`	string	URL de la foto de perfil.
`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.

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.
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.

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