¿Para qué sirve?
La API de Recaudación permite crear sesiones de pago para que tus usuarios paguen directamente, sin que tu plataforma intermedie los fondos. Con un solo endpoint, Tupana:- Procesa el pago vía tarjeta de débito, crédito o transferencia bancaria (Transbank).
- Deposita el monto neto al destinatario directamente.
- Emite el DTE (boleta o factura electrónica) al confirmar el pago.
- Te notifica vía webhook con el resultado.
Flujo general
- Tu plataforma crea una sesión de cobro llamando a
POST /v1/payment-requests/. Tupana retorna unapayment_url. - Redirige al usuario a esa URL. El usuario paga en el checkout de Tupana (o directo a Transbank si usas
skip_portal: true). - Tupana procesa el pago con Transbank, actualiza el estado de la sesión y emite el DTE (si corresponde).
- Tupana te notifica vía webhook con un
POSTfirmado a tu endpoint registrado. - Tu plataforma confirma la cita, orden o servicio del lado tuyo.
Dos modos: emisión vs. cobro directo
El mismo endpointPOST /v1/payment-requests/ soporta dos escenarios:
Los dos modos son mutuamente excluyentes — si envías
document_ids, omite amount, target_dte_type, dte_recipient e items. En modo cobro directo:
- El monto del cobro es la suma de los
amount_with_ivade los documentos. - Todos los documentos deben pertenecer al
recipient_id, compartir el mismo pagador (receiver), ser de un tipo cobrable (33, 34, 39, 41, 80, 110) y no estar pagados. - No hay emisión de DTE al confirmarse el pago — los documentos ya existen.
Autenticación
Todos los endpoints requieren tu API key en el header de autorización:Ambiente de pruebas (Sandbox)
El sandbox usa el ambiente de integración de Transbank. Podés probar el flujo completo — pagos, webhooks y emisión de documentos — sin mover dinero real ni emitir DTEs al SII. El mismo código funciona en producción y sandbox: solo cambia la API key que usás.Tarjetas de prueba (Transbank integración)
CVV:
123 · Vencimiento: cualquier fecha futura · RUT: 11.111.111-1 · Clave banco: 123