Lea antes:
../conectores.md(mapa de estados) yfichas.md(índice de las fichas).
⚠️ Aviso — Roadmap (no disponible)#
Este conector no está implementado: la configuración y la ejecución son rechazadas por el producto (no finge éxito).
La API pública de PagBank consulta pedidos y cobros por identificador y no ofrece listado paginado de la cuenta — sin endpoint de listado no hay forma de extraer en el agendamiento.
El resto de esta página describe la especificación planificada (campos y forma de conexión), no una funcionalidad activa.
Qué es#
Conector planificado: la lectura de los cobros de PagBank aún no existe porque la API no lista la movimentación de la cuenta — hoy los datos entran por exportación del extracto a la zona de recepción.
Modos de ingestión soportados:
- Nosotros buscamos — Nosotros buscamos los datos en tu fuente.
Para qué sirve#
Traer los datos de PagBank a tu datalake y ponerlos a disposición en las capas Bronze/Silver/Gold, a los modelos de BI y al asistente de preguntas en lenguaje natural.
Cuándo usar / cuándo no usar#
Usa cuando necesitas consolidar esta fuente en el datalake de forma agendada, con aislamiento por workspace.
No uses para producción hoy: el conector está en Roadmap. Mientras tanto, para archivos, usa el modo "Você deposita" (envía los archivos a la landing).
Plan y permisos#
- Plan: núcleo del producto (los conectores forman parte de todos los planes; el límite es la cantidad de fuentes del plan).
- Acceso: requiere workspace activo — con la suscripción en atraso, suspendida o cancelada, la ejecución queda bloqueada.
- Apagado: la ejecución de ingestión puede ser desactivada temporalmente (mantenimiento o incidente). Cuando eso sucede, la pantalla informa que el recurso está indisponible en este momento.
Pre-requisitos#
- Una cuenta PagBank con acceso a los datos que quieres ingerir.
- Cuando el conector exista, la conexión usará un token de la API de PagBank (Integrações → Chaves). Hoy la API no lista los cobros de una cuenta — sólo consulta por identificador —, así que la configuración es rechazada y el camino es exportar el extracto a la zona de recepción de tu entorno.
Credenciales#
Forma de autenticación: Token de acceso pegado por ti. Está cifrado (AES-256-GCM) y nunca se muestra de nuevo, ni aparece en logs o mensajes de error.
Este conector no exige secretos propios (modo de upload / sin credencial en la plataforma).
Los secretos nunca se vuelven a mostrar y pasan por enmascaramiento en cualquier error/log (token en crudo, URL-encoded y en JSON).
Campos del formulario#
| Campo | Etiqueta | Tipo | Obligatorio | Observación |
|---|---|---|---|---|
contaPagbank | Conta PagBank (informativo) | texto | no | Sólo para registro de interés — la configuración es rechazada mientras el conector no exista. |
Paso a paso#
- No menu Dados → Conexões, use Nova conexão.
- Elige PagBank en el catálogo.
- Completa los campos del formulario (ver la tabla arriba).
- Use Testar conexão. El resultado viene separado en Conectividade, Autenticação y Listagem/leitura — cada uno con OK, Falló, No aplica o No probado. Una capacidad sin prueba propia para este conector aparece como No aplica, y No aplica nunca cuenta como éxito.
- Usa Salvar conexão. Guardar NO inicia ninguna ingestión.
- En la tarjeta de la conexión, usa Montar extração (o ve a Orquestração → Pipelines y usa Conectar fonte). El pipeline apunta a la conexión guardada — la credencial no es copiada.
- En la revisión, Publicar (agenda desligada) crea la versión 1 sin ejecutar nada. Después, Ativar agenda y Executar agora son acciones separadas.
En el estado actual (Roadmap), los pasos 4–5 son rechazados por el producto.
Ejemplo — prueba de conexión#
Configuración de ejemplo (todos los valores son ficticios; los secretos aparecen enmascarados):
# Exemplo sintético (valores fictícios — não são credenciais reais)
contaPagbank = <contaPagbank>Resultado esperado#
El producto rechaza la configuración con un mensaje claro de que el conector está en Roadmap.
Límites y costos#
- Paginación: techo duro por ejecución (por defecto 10.000 páginas / 5.000.000 filas); protección anti-bucle.
- Carga SaaS: por defecto
batchSize5.000,maxRows200.000 por recurso. - Volumen estimado: ~0.3 GB/mes (estimación de catálogo, no medición).
- **
Seguridad#
- Alcance por workspace: cada cliente lee y escribe sólo en su propio datalake (
<prefixo>_bronze/_silver/_gold); nunca hay filtración entre workspaces. - Secretos cifrados: material sensible se cifra con AES-256-GCM antes de ser grabado. El cofre externo de credenciales es opcional y se conecta por la conexión; sin él, el valor cifrado queda en la base. Cambiar el valor aquí NO revoca la credencial en el origen.
- Enmascaramiento: todo error/log pasa por el enmascaramiento de secretos (crudo, URL-encoded y en JSON).
- Producción no simula: un camino que caería en mock activa la protección de producción (falla explícita en vez de simular éxito).
Errores comunes#
- Credencial rechazada (401/403) — el proveedor no aceptó la credencial: expirada, revocada o sin el permiso necesario. Reconecta la fuente (la fuente y el historial se preservan; no recrees la fuente).
- Límite de solicitudes (429) — el proveedor pidió esperar. La extracción respeta
Retry-Aftery reintenta; si se repite, espera y reduce la frecuencia de la agenda. - Recurso no encontrado — verifica el identificador del recurso (cuenta, objeto, reporte) y los permisos concedidos.
- Cursor de paginación bloqueado — la extracción finaliza cuando el cursor de la API no avanza (protección anti-bucle). Si ocurre en ejecuciones consecutivas, abre un ticket con soporte indicando el conector y el recurso.
- Ruta de registros vacía — la respuesta llegó sin registros en el lugar esperado. Verifica el recurso seleccionado y los filtros (periodo, cuenta, estado) antes de asumir que no hay datos.
Solución de problemas#
- Usa Testar conexão para aislar problemas de credencial/red antes de agendar.
- Acompaña las ejecuciones en la observabilidad por conector (tasa de error, p50/p95, freshness).
- Un cambio de esquema en la fuente se señala por el schema drift (columna nueva = info; columna removida/tipo cambiado = atención).
Relacionados#
../conectores.md— catálogo de conectores por estado../ingestao-incremental-backfill.md— full, incremental por watermark, backfill y checkpoint../pipeline-medalhao.md— capas Bronze/Silver/Gold y calidad../agendamento-retry-dlq.md— agendamiento, retry/backoff y DLQ../custo-limites-seguranca.md— costo, techos y seguridad por workspace
Última revisión: 2026-10-04. Ficha generada automáticamente del catálogo de conectores del producto.