Ir al contenido
Capi, el capibara de TuCapi

Cobros y pagos en Venezuela, con una sola API

Cobre por Pago Móvil, débito con código o transferencia, y pague a cualquier banco del país. Idempotencia, webhooks firmados y SDK oficiales desde el primer pedido.
1integración para cobrar y pagar
4métodos de cobro
3estados públicos: pending, confirmed, failed
3SDK oficiales: Go, Node y Python
POST /v2/payouts
curl -X POST https://api.tucapi.app/v2/payouts \
-H "Authorization: Bearer $LLAVE" \
-H "Idempotency-Key: orden-4821" \
-H "Content-Type: application/json" \
-d '{
"country": "VE",
"currency": "VES",
"method": "mobile_payment",
"amount": "1500.50",
"beneficiary": {
"name": "Nombre Apellido",
"document": { "type": "V", "number": "12345678" },
"bank_code": "0102",
"account_number": "04121234567"
}
}'

El desenlace le llega por webhook firmado (payout.confirmed o payout.failed), o lo consulta cuando quiera con GET /v2/transactions/{id}.

Cobrar

Débito con código de un solo uso, débito domiciliado, o esperar el Pago Móvil o la transferencia que su cliente manda. Ver cobros →

Pagar

Pago Móvil o transferencia a cualquier banco, con su saldo a la vista y cancelación mientras esté pendiente. Ver pagos →

Enterarse al instante

Webhooks firmados con HMAC-SHA256, reintentos automáticos y la lista de eventos para conciliar. Ver webhooks →

Reintentar sin miedo

Idempotency-Key en cada creación: el mismo pedido devuelve la misma operación, nunca un pago doble. Ver idempotencia →

Sandbox completo

Una llave tuc_test_ y la URL https://api.tucapi.app/sandbox: el mismo contrato, sin mover dinero, con documentos de prueba de desenlace fijo.

Un contrato, todas las piezas

OpenAPI 3.1 como única fuente de verdad: de ahí salen esta documentación, los SDK y el servidor MCP.

Errores que se pueden programar

Un solo sobre de error y códigos cerrados para hacer switch, en la API y en cada fallo de operación.

Listo para asistentes de IA

llms.txt, cada página en Markdown y un servidor MCP de sólo lectura para Claude, ChatGPT, Gemini o Codex.