#

Usar el Portal

El Portal es la interfaz web donde administrás tu integración sin escribir código: configurás URLs, das de alta sedes y (en test) generás todo lo que necesitás para probar el flujo de punta a punta.

#

Acceso

Entrá al Portal y logueate con tus credenciales de admin de la integración (las mismas del email de bienvenida, ya con tu contraseña cambiada). Todo lo que ves acá está anclado a tu integración: no hay forma de tocar la de otro.

#

Configurar webhook + redirect URI

Desde Mi integración → Configuración cargás tu webhook URL (donde recibís los avisos de pago), tu redirect URI (para el flujo OAuth) y el token de validación. Es exactamente lo mismo que hacen los endpoints de Primeros pasos, pero desde la interfaz.

#

Elegir qué avisos recibís

En Avisos elegís qué eventos de webhook recibe tu integración: te mandamos únicamente los que estén marcados. Es donde activás payment.unmatched, que nace apagado.

La lista es UNA sola por integración, no una por URL: aplica a todas las URLs que tengas configuradas, la de la integración y la de cada sede. Y si destildás todo, tu integración deja de recibir webhooks por completo.

Ojo con el nombre: "Avisos" son los eventos de webhook que recibe TU sistema, y el contrato de cada uno está en la guía de Webhooks. No son los avisos al pagador (WhatsApp y mail), que son otra cosa y viven en la guía de Notificaciones.
#

Gestionar sedes (tenants)

Si tu integración maneja varias unidades de negocio, desde el Portal das de alta cada sede con su propio webhook. Cada pago llega solo a la sede que lo generó.

#

Cobrar una comisión

En Distribución configurás qué porcentaje de cada pago te quedás, e invitás a la cuenta que las recibe (el recaudador). Ojo: con la comisión configurada pero sin recaudador aceptado, cada pago la saltea y no cobrás nada.

#

Combo de testing

El verdadero valor del Portal en test: generar un usuario de prueba ya vinculado y simular un pago entrante, para recorrer el flujo completo sin plata real ni un pagador de verdad.

Este endpoint está disponible SOLO en test. En producción NO existe.
Generar un token OAuth de prueba
POSTPOST /my-integration/test-oauth-tokens

Genera un token OAuth de un usuario B2C de prueba ya vinculado a tu integración, listo para llamar POST /payment-request. NO tiene body: la identidad sale del JWT de admin con el que llamás.

Ver ejemplo
curl
curl -X POST {{integration-admin-url}}/my-integration/test-oauth-tokens \
  -H "Authorization: Bearer {admin_id_token}"

Response

json
{
  "idToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600,
  "autoLinkAction": "linked"
}
#

Flujo de prueba recomendado

1
Seteá webhook + redirect URI en el Portal.✓
2
Generá un test-token con POST /my-integration/test-oauth-tokens.✓
3
Creá un payment-request con ese token (POST /payment-request).✓
4
Activá en Avisos los eventos que quieras recibir (payment.unmatched arranca apagado).✓
5
Simulá el pago entrante desde el Portal.✓
6
Verificá que el webhook llegó a tu URL. La respuesta del simulador te dice en webhookWillFire si el evento estaba suscrito.✓