POST/api/v1/integrations/consumptions

🔐 Bearer (OAuth) o X-Api-Key♻️ Requiere Idempotency-KeyContrato en borrador

Confirma una autorización y registra el consumo (canje). Llámalo después de cobrar la compra. El consumo queda visible para tu comercio, para la empresa y para el colaborador en su historial de COME.

Encabezados

Encabezado	Requerido	Descripción
Authorization o X-Api-Key	Sí	Tu credencial. Ver Autenticación.
Idempotency-Key	Sí	UUID único de esta operación (distinto al usado en apply).

Petición

Campo	Tipo	Requerido	Descripción
authorizationCode	string	Sí	Código devuelto por Aplicar descuento.
reference	string (≤ 64)	Sí	La misma reference usada al aplicar.
consumptionDate	date-time	Sí	Fecha y hora del cobro, ISO 8601 con zona horaria.
purchaseAmount	number	No	Nuevo total si la compra cambió después de autorizar. COME recalcula y nunca otorga más de lo autorizado.

OAuth (Bearer)

curl -s -X POST "$COME_BASE_URL/api/v1/integrations/consumptions" \
  -H "Authorization: Bearer $COME_TOKEN" \
  -H "Idempotency-Key: 5b7e9c11-2a4d-4e8f-b0c3-1d2e3f4a5b6c" \
  -H "Content-Type: application/json" \
  -d '{
    "authorizationCode": "AUT-7K2Q9M",
    "reference": "TICKET-000123",
    "consumptionDate": "2026-09-27T18:03:21-04:00"
  }'

API key

curl -s -X POST "$COME_BASE_URL/api/v1/integrations/consumptions" \
  -H "X-Api-Key: $COME_API_KEY" \
  -H "Idempotency-Key: 5b7e9c11-2a4d-4e8f-b0c3-1d2e3f4a5b6c" \
  -H "Content-Type: application/json" \
  -d '{ "authorizationCode": "AUT-7K2Q9M", "reference": "TICKET-000123", "consumptionDate": "2026-09-27T18:03:21-04:00" }'

Respuesta 201

{
  "title": "Consumption",
  "messages": [{ "message": "Creation successful" }],
  "value": {
    "code": "CON-20260927-000184",
    "authorizationCode": "AUT-7K2Q9M",
    "reference": "TICKET-000123",
    "status": "Registered",
    "currency": "DOP",
    "purchaseAmount": 1500.0,
    "discountAmount": 225.0,
    "finalAmount": 1275.0,
    "consumptionDate": "2026-09-27T22:03:21Z"
  },
  "meta": null
}

Guarda code: es el identificador del consumo en COME y el que verás en Consumos del portal de comercios.

Errores

HTTP	Cuándo
400	La autorización venció o ya se usó, o los datos son inválidos. Si venció, vuelve a aplicar el descuento.
404	No existe una autorización con ese código y esa reference para tu comercio.
409	La Idempotency-Key ya se usó con un cuerpo distinto.
401 / 403 / 429	Ver Errores.