Introducción

PagusPay es una API de pagos para enviar USDC → Pix — usted deposita saldo en USDC en una cuenta de stablecoins, y PagusPay convierte y liquida en cuentas bancarias brasileñas vía Pix, usando claves Pix estándar (CPF, CNPJ, email, teléfono o EVP) para identificar a los beneficiarios.

Solo creación (maker-only) por diseño

La API es, deliberadamente, maker-only. Todo lo que puede hacer vía API se detiene en el envío:

• Crear beneficiarios
• Crear lotes de pago (borrador)
• Enviar un lote para aprobación

La aprobación y la ejecución son siempre humanas. Todo lote de pago que mueve dinero requiere un paso maker/checker con confirmación de dos factores (2FA por email), realizado por una persona en el panel de PagusPay. No existe endpoint de API para aprobar, rechazar o ejecutar un lote — esto es un límite de seguridad deliberado, no una funcionalidad faltante.

API (usted)                        Panel (humano)
──────────                         ──────────────────
POST /v1/recipients        ──►
POST /v1/payout-batches    ──►     draft
POST .../{id}/submit       ──►     pending_approval
                                    │
                                    ▼
                            aprobación + 2FA (maker/checker)
                                    │
                                    ▼
                            executing → completed

Qué puede construir

• Rutinas automatizadas de nómina o pago a proveedores que se detienen en pending_approval, listas para la aprobación humana
• Gestión de beneficiarios sincronizada con su propio sistema de registro
• Paneles de solo lectura sobre saldos, beneficiarios y estado de lotes

Próximos pasos

• Autenticación — cómo crear y usar tokens de API
• Guía de Pagos — el flujo completo de beneficiario → lote → envío con solicitudes reales
• Referencia de la API — documentación completa de los endpoints, generada a partir de la especificación OpenAPI