Marca blanca
Recomendaciones para integrar Cobru dentro de tu propia experiencia de producto con mínima fricción para el usuario final.
Cobru puede sentirse integrado en tu producto incluso cuando el checkout o ciertas superficies siguen siendo hosted, si diseñas bien la transición. El material original de Spotlight también documenta una superficie de registro de usuarios white-label importante para productos financieros embebidos.
El onboarding white-label y los usernames prefijados por marca vienen de documentación legacy de Cobru. No lo publiques como contrato definitivo sin confirmarlo con tu equipo de Cobru.
Qué cubre esta capability
- registrar usuarios bajo un namespace o marca aliada
- consultar categorías y subcategorías antes del registro
- confirmar correo y teléfono
- integrar flujos Cobru dentro de la experiencia de tu propio producto
Flujo de registro
Consulta categorías con GET /category/ y subcategorías con GET /subcategory?category_id=....
Recolecta el payload de registro con brand, username, documents y campos legales.
Crea el usuario con POST /user/.
Completa flujos posteriores como confirmación de correo y teléfono.
Payload de ejemplo
{
"username": "09906786442",
"first_name": "Test",
"last_name": "User",
"email": "test@example.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,
"category": 99,
"platform": "ios",
"brand": "MY_BRAND"
}const response = await fetch('https://dev.cobru.co/user/', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.COBRU_API_KEY!,
},
body: JSON.stringify(userPayload),
});
const createdUser = await response.json();
console.log(createdUser.username);import requests
response = requests.post(
"https://dev.cobru.co/user/",
headers={
"x-api-key": COBRU_API_KEY,
"Content-Type": "application/json",
},
json=user_payload,
)
print(response.json())<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('POST', 'https://dev.cobru.co/user/', [
'headers' => [
'x-api-key' => getenv('COBRU_API_KEY'),
'Content-Type' => 'application/json',
],
'json' => $userPayload,
]);
$createdUser = json_decode((string) $response->getBody(), true, 512, JSON_THROW_ON_ERROR);
var_dump($createdUser);Reglas de integración
Recomendaciones UX
- anticipa el siguiente paso antes de redirigir al usuario
- incluye tu propio identificador de referencia en el
callback - guarda
pk,urleidempotency_keyde Cobru - diseña una return URL que explique estado y siguientes acciones
- documenta UX específica por método de pago, especialmente BRE-B y QR