Envío entre usuarios

Transfiere saldo de forma instantánea entre wallets de usuarios Colurs.

Visión General

Tipos de envío

Send clásico

Crear un envío indicando el username del destinatario. El sistema valida KYC, balance suficiente y límites (para COP).

Flujo

POSThttps://dev.backend.colurs.co/send/estimate/user/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

POSThttps://dev.backend.colurs.co/send/user/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

{
"to_user": "+573001234567",
"from_user": "+573009876543",
"created": true,
"pk": 12345,
"date": "2026-02-03T10:00:00Z",
"amount": 50000.00
}

Últimos usuarios a los que se envió

GEThttps://dev.backend.colurs.co/send/last_users_sended/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

{
"to_user": "+573001234567",
"from_user": "+573009876543",
"created": true,
"pk": 12345,
"date": "2026-02-03T10:00:00Z",
"amount": 50000.00
}

Enviar a cuenta bancaria (retiro)

Estimar: POST /send/estimate/user/ con send_channel: “DALE”, amount, currency, ip, latitude, longitude, is_for_quote: false. Ejecutar: POST /create/third_party_withdraw/ (ver Retiros Bancarios).

Enviar USD (depósito)

Iniciar: POST /usd/owner/payment — Body: deposit_option, currency (USD), amount, ip, latitude, longitude. Confirmar: POST /usd/user/deposit — Body: check_id, account_id, withdraw_id. Listar cuentas: GET /usd/user/account.

GEThttps://dev.backend.colurs.co/send/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Lista de envíos (formato según serializer ListSend).

Fast Send (envío rápido)

Envío por ID de usuario con opción de estimar costos antes de ejecutar. Soporta canales con y sin comisión.

Canales de envío

POSThttps://dev.backend.colurs.co/send/estimate/user/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

request.json{
"amount": 50000,
"currency": "COP",
"send_channel": "COLURS",
"is_for_quote": true
}

curl -X POST "https://dev.backend.colurs.co/send/estimate/user/" \
-H "Authorization: Bearer [TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{
  "amount": 50000,
  "currency": "COP",
  "send_channel": "COLURS",
  "is_for_quote": true
}'

{
"result": {
  "amount": 50000.00,
  "fee_amount": 1000.00,
  "fee_iva_amount": 190.00,
  "payed_amount": 51190.00,
  "gmf_amount": 200.00,
  "full_name": 
"Juan Pérez"}
}

POSThttps://dev.backend.colurs.co/send/user/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

request.json{
"to_user": 42,
"amount": 50000,
"currency": "COP",
"send_channel": "COLURS",
"ip": "192.168.1.1",
"latitude": "4.60971",
"longitude": "-74.08175",
"description": "Reembolso"
}

curl -X POST "https://dev.backend.colurs.co/send/user/" \
-H "Authorization: Bearer [TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{
  "to_user": 42,
  "amount": 50000,
  "currency": "COP",
  "send_channel": "COLURS",
  "ip": "192.168.1.1"
}'

{
"message": "OK",
"data": {
  "id": 12345,
  "currency": "COP",
  "fee_amount": 1000.00,
  "fee_iva_amount": 190.00,
  "amount": 50000.00,
  "payed_amount": 51190.00
}
}

Envío múltiple (estimación)

POSThttps://dev.backend.colurs.co/send/estimate/multiple-user/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

request.json{
"profiles": [
  { "profile_id": 10, "amount": 100000, "send_channel": "COLURS" },
  { "profile_id": 11, "amount": 50000, "send_channel": "DALE" }
],
"currency": "COP",
"is_for_quote": true
}

Objeto con el desglose total estimado (amount, fee_amount, fee_iva_amount, payed_amount según la lógica de múltiple send).

Envío múltiple (dispersar a cuentas bancarias)

Ejecuta el envío de dinero a múltiples cuentas bancarias en una sola petición. Cada elemento en profiles indica el destinatario (por profile_id o por third_party_bank_id), el monto y el canal (ej. cuenta bancaria asociada). Usa primero POST /send/estimate/multiple-user/ para cotizar y luego este endpoint para ejecutar.

POSThttps://dev.backend.colurs.co/send/multiple-user/

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

request.json{
"currency": "COP",
"profiles": [
  {
    "profile_id": 10,
    "amount": "100000",
    "send_channel": "BANCO_BAN100",
    "third_party_bank_id": 5
  },
  {
    "profile_id": 11,
    "amount": "50000",
    "send_channel": "BANCO_BAN100",
    "third_party_bank_id": 8
  }
],
"ip": "192.168.1.1",
"latitude": "4.60971",
"longitude": "-74.08175",
"is_for_quote": false
}

{
"result": {
  "message": 
"OK"}
}