Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-10-04

PagBank — conector

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.

En esta página (16)

Lea antes: ../conectores.md (mapa de estados) y fichas.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#

CampoEtiquetaTipoObligatorioObservación
contaPagbankConta PagBank (informativo)textonoSólo para registro de interés — la configuración es rechazada mientras el conector no exista.

Paso a paso#

  1. No menu Dados → Conexões, use Nova conexão.
  2. Elige PagBank en el catálogo.
  3. Completa los campos del formulario (ver la tabla arriba).
  4. 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.
  5. Usa Salvar conexão. Guardar NO inicia ninguna ingestión.
  6. 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.
  7. 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):

text
# 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 batchSize 5.000, maxRows 200.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-After y 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#


Última revisión: 2026-10-04. Ficha generada automáticamente del catálogo de conectores del producto.

Enlaces relacionados