Paso a paso
1
Elige los productos que usa el socio
Pix Lerian son cuatro productos en Access Manager. Da al socio solo los productos que necesita:
El adaptador de conectividad no acepta socios. Solo los servicios de Pix Lerian lo llaman.
2
Elige las cuentas en las que actúa el socio
Pix Lerian tiene una restricción, la misma en los cuatro productos:
Pix Lerian no tiene restricción de organización ni de ledger. Cada tenant opera una organización y un ledger de Midaz. La configuración del tenant los define, y ninguna solicitud los indica. Para restringir un socio a un ledger, dale también un alcance en Midaz. Consulta Las reglas del socio en Midaz valen para sus llamadas.
3
Da al socio sus permisos y su alcance
Crea el socio, o modifícalo, en la Consola o con la API de Identity. Usa los slugs de producto del primer paso. La restricción acepta varias cuentas.
- Agrega la entrada de alcance
accountIden cada producto de Pix Lerian que des. Sin ella, Access Manager rechaza el socio con400eIDE-1060. - Revisa los recursos y las acciones. Lo máximo que puedes dar es lo que tiene el rol de editor de cada producto en tu tenant. Por encima de eso, Access Manager rechaza con
IDE-1043.
- Los bloqueos de saldo.
- La bandeja de salida de notificaciones.
- Las rutas de operador que ejecutan y recuperan trabajos.
- La recuperación de una transferencia o de una devolución:
transfer-recoveryyrefund-recovery, acciónpost. - La configuración de runtime.
400 e IDE-1056, y la Consola marca la línea como Fuera del alcance.Access Manager también rechaza, con el mismo código, las escrituras que cambian una clave, abren una recuperación de fondos o crean un pago recurrente. Consulta Rutas que ningún socio alcanza.4
Crea sus aplicaciones de Pix Lerian
Crea las aplicaciones del socio con los productos de Pix Lerian que le diste. Consulta Crea las aplicaciones del socio en la guía de la API, o en la Consola. Envía el client ID y el client secret al socio por un canal seguro.
5
Indica la cuenta en cada solicitud
Toda solicitud indica la cuenta en un campo que Pix Lerian ya tiene. El valor debe estar en el alcance del socio. Un socio debe enviar la cuenta en todas las rutas de esta tabla, también donde el campo es opcional para otros llamadores. Una solicitud sin ella se rechaza.
Una solicitud que indica un registro de otra cuenta responde
404, como si el registro no existiera. No se lee ni se cambia nada.6
Confirma que funciona
Esta verificación supone que el socio tiene el recurso Envía la misma solicitud con una cuenta fuera del alcance del socio. La respuesta es
transfers con la acción get en plugin-br-pix-lerian-spi, y un alcance con una o más cuentas. Usa la credencial del socio. Lista las transferencias de una cuenta del alcance del socio. La respuesta es 200:403 con PIX-0010.Las reglas del socio en Midaz valen para sus llamadas
Algunos productos de Pix Lerian llaman a Midaz mientras atienden la solicitud del socio:
- SPI registra los débitos y los créditos en el ledger, y lee la cuenta y su titular.
- DICT hub y Pix Automático leen el titular y la cuenta en el CRM integrado en Midaz.
403 y PIX-0005, y el saldo de la cuenta no cambia.
- Un socio sin permisos en Midaz se decide solo por sus permisos y su alcance en Pix Lerian.
- Puedes dar al socio sus reglas de Midaz en el mismo flujo de la Consola, o después, en el producto Midaz.
- Los barridos programados, los callbacks del proveedor y los demás trabajos en segundo plano se ejecutan sin socio. Las reglas del socio no se aplican allí.
Rutas que ningún socio alcanza
Un socio con alcance en Pix Lerian se rechaza con
403 y PIX-0010 en las rutas que no llevan cuenta:
- SPI: todas las rutas de
/spi/v1/balance-locks, las rutas de un pago programado o de una recurrencia (/spi/v1/scheduled-payments/{schedule_id}y/spi/v1/scheduled-payment-recurrences/{recurrence_id}, con las rutas debajo de ellas), y las rutas de operador. - DICT hub:
POST /dict-hub/v1/claims/{claim_id}/acknowledge,POST /dict-hub/v1/keys/check, las rutas de una recuperación de fondos, y las rutas de notificaciones de infracción, devoluciones, marcas de fraude y VSync. - COB hub:
POST /cob-hub/v1/brcodes/decode,GET /cob-hub/v1/brcodes/staticyGET /cob-hub/v1/brcodes/static/{id}. - Pix Automático:
POST /pixauto/v1/payer/recurring-consentsyPOST /pixauto/v1/payer/recurring-consents/{recurring_consent_id}/revoke.
PATCH /dict-hub/v1/entries/{entry_id}: la solicitud puede mover la clave a otra cuenta.POST /dict-hub/v1/dict/funds-recoveries: la ruta abre la recuperación sobre una transacción que la cuenta no vincula.POST /pixauto/v1/payer/recurring-payments: la ruta acepta el pago bajo un consentimiento que la cuenta no vincula.
POST /spi/v1/transfers/{id}/unblockyPOST /spi/v1/transfers/{id}/credit.POST /spi/v1/refunds/{id}/unblockyPOST /spi/v1/refunds/{id}/credit.
Si algo falla
PIX-0010 no dice si fueron los permisos o el alcance los que rechazaron la solicitud. Es intencional: un socio no puede usar un rechazo para saber qué cuentas existen fuera de su alcance.
Un cambio en un socio, como una suspensión o un nuevo alcance, vale desde su siguiente solicitud, también con un token que ya tiene.
Para todos los demás códigos, consulta la lista de errores de Pix Lerian. Para los rechazos al crear o cambiar un socio, consulta Códigos de error en la guía de la API.
