Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt

Use this file to discover all available pages before exploring further.

El modo direct está pensado para sistemas donde el pago ya fue capturado fuera de Cobrix (POS físico, facturación automática, conciliación manual) y solo necesitas registrarlo. La respuesta trae status: "completed" de inmediato.

​
Cuándo usarlo

POS físico

Registrar el pago en Cobrix después de cobrar en caja

Billing automatizado

Cargos recurrentes o procesos internos sin interacción del cliente

Conciliación

Importar pagos recibidos fuera de la plataforma

Integraciones externas

Flujos donde otro sistema ya capturó los fondos

​
Request

curl -X POST "https://api.cobrix.co/api/external/payments/direct" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_acme_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "customerEmail": "[email protected]",
    "amountMinor": 15000,
    "currency": "VES",
    "paymentMethod": "pago_movil",
    "description": "POS sale #456",
    "externalReference": "pos-456",
    "paymentDetails": {
      "reference": "0123456789",
      "bank": "0102"
    }
  }'

​
Métodos de pago

MonedaMétodos disponibles
VESpago_movil, bank_transfer, cash_ves
USDzelle, binance, paypal, cash_usd
CRCsinpe, sinpe_transferencia
Genéricoscash, card, c2p, wallet, other
El objeto paymentDetails es opcional y acepta metadatos específicos del método (número de referencia, banco, comprobante, etc.).

​
Response

{
  "id": "a1b2c3d4-...",
  "status": "completed",
  "mode": "direct",
  "amountMinor": 15000,
  "currency": "VES",
  "invoiceId": "inv-uuid",
  "paymentId": "pay-uuid",
  "externalReference": "pos-456",
  "completedAt": "2026-03-26T14:30:00.000Z",
  "createdAt": "2026-03-26T14:30:00.000Z"
}

​
Webhook opcional

Si proporcionas callbackUrl, Cobrix también dispara external_payment.completed. En la mayoría de los casos no lo necesitas: la respuesta del POST ya confirma la operación.

​
Diferencias vs modo hosted

HostedDirect
Estado inicialpendingcompleted
checkoutUrl✅❌
Interacción del cliente✅❌
paymentMethod requerido❌✅
paymentId en la respuestaAl completarseInmediato