Enviar dinero
Envía saldo Cobru a otro usuario Cobru.
Este contrato proviene de materiales legacy de Cobru. Revalida request y response exactos en sandbox antes de usarlo en un flujo de transferencias de producción.
Endpoint
POST https://dev.cobru.co/send/
Content-Type: application/json
Authorization: Bearer <access_token>Requisitos
- el emisor debe tener email y teléfono verificados
- el destinatario se identifica por
username, por ejemploMY_BRAND-3001234567 - el monto se descuenta del saldo disponible del usuario autenticado
Campos del request
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
toUser | string | sí | Username al cual se va a enviar dinero. Ejemplo: MY_BRAND-3001234567. |
amount | number | sí | Cantidad de dinero que se va a enviar. Ejemplo: 99000. |
En materiales anteriores también aparece to_user. Confirma con Cobru cuál alias está
activo para tu integración antes de pasar a producción.
Ejemplo de body
{
"toUser": "MY_BRAND-3001234567",
"amount": 99000
}Confirmación de correo y teléfono
Antes de enviar dinero, el usuario emisor debe tener el correo electrónico y el celular en estado verificado. Primero solicita los códigos de confirmación:
POST http://dev.cobru.co/request_confirmation/
Content-Type: application/json
Authorization: Bearer <access_token>| 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 realiza una llamada por cada canal.
Confirmar correo electrónico
POST http://dev.cobru.co/verify_email/
Content-Type: application/json
Authorization: Bearer <access_token>| 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
Authorization: Bearer <access_token>| Campo | Tipo | Descripción |
|---|---|---|
code | integer | Código recibido en el teléfono. |
Notas de producción
- Valida KYC y estado operativo del emisor antes de exponer esta acción en UI.
- Los materiales públicos no confirman si el envío es síncrono, en cola o reversible.
- Trata el éxito del envío como no confiable hasta reconciliarlo vía
GET /send/o con tu propio ledger downstream.