v2.43.0 — Granular scopes on integration credentials
v2.43.0 — Granular scopes on integration credentials
- You choose what each credential can do. When creating a credential in the
panel (API Credentials), a tenant manager picks the scopes:
read,qrcode.manage,pix_keys.manage,webhooks.manage,exports.createandmed.defend. A credential without the route’s scope gets403 insufficient_scopenaming the missing scope. - A QR-code credential can see its own QR’s payment.
qrcode.managecovers creating, cancelling and reading the QR (GET .../pix/qr-code/lookup), so you can have a charge-only credential with no access to balance or statement. - Per-account restriction. A credential can be limited to specific accounts of the tenant — that is how you give a subsystem access to a single account. No user can issue a credential broader than their own access.
- Money-moving scopes are issued by CorpX (
pix_out.create,refund.create,internal_transfer.create,ted.create,boleto_payment.create,med.decide). Requesting one from the panel returns403 scope_not_self_service. - Existing credentials are unchanged. Current integrations keep full access
(
api2/read api2/write) and need no action.
Details in the Authentication Guide.
v2.43.1 — Inflow credential with no access to balance or statement
v2.43.1 — Inflow credential with no access to balance or statement
readis no longer mandatory. It now covers only the account-wide queries (balance, statement, timeline, entries) and is optional when creating a credential. Previously every credential was issued withread, which blocked the very use case granularity exists for.- Every scope queries its own domain.
qrcode.managealone creates the QR and sees whether it was paid;pix_keys.managelists the keys;exports.createdownloads the file;webhooks.managefollows the deliveries;med.defendqueries the MEDs. The same holds for cashout scopes and the status of their own operations. qrcode.manageplus one account is now a credential that charges by QR code on that account and sees nothing else.- Credentials already issued are unchanged — those created earlier keep the
readthey were given. To restrict, issue a new credential and revoke the old one.
Details in the Authentication Guide.