Skip to main content

Pix e Pix Automático

Cobranças Pix com QR Code, as contas Pix que as recebem e o Pix Automático: contas, recorrências, solicitações, cobranças e locations.

Famílias nesta página​

FamíliaToolsreadwritedestructive
Cobranças Pix8422
Contas Pix5203
Pix Automático — contas5212
Pix Automático — recorrências6231
Pix Automático — solicitações5221
Pix Automático — cobranças6213
Pix Automático — locations3210

Cobranças Pix​

Escopo: banking/charge.pix

ToolTipoPermissãoEspelhaO que faz
banking_charge_pix_listreadcharge.pix.basicGET /v2/charge/pixLists Pix charges (cobranças Pix) the account issued, most recent first, with filters that combine.
banking_charge_pix_getreadcharge.pix.basicGET /v2/charge/pix/:uidReturns every field of one Pix charge, including its QR code, payer and payments, in the same shape as the API v2.
banking_charge_pix_createwritecharge.pix.createPOST /v2/charge/pixIssues a Pix charge (cobrança Pix) with a QR code for the payer.
banking_charge_pix_updatewritecharge.pix.updatePUT /v2/charge/pix/:uid/updateChanges an open Pix charge (amount, due date, payer, penalties, discounts).
banking_charge_pix_canceldestructivecharge.pix.cancelPUT /v2/charge/pix/:uid/cancelAsks the Pix provider to cancel a charge, so it can no longer be paid.
banking_charge_pix_deletedestructivecharge.pix.destroyDELETE /v2/charge/pix/:uidDeletes a canceled Pix charge from the account.
banking_charge_pix_command_listreadcharge.pix.basicGET /v2/charge/pix/:pix_uid/commandsLists the update and cancel commands sent to the Pix provider for one charge, most recent first, with their status.
banking_charge_pix_command_getreadcharge.pix.basicGET /v2/charge/pix/:pix_uid/commands/:uidReturns one update or cancel command of a Pix charge, with its status at the provider.

Contas Pix​

Escopo: banking/charge.pix_accounts

ToolTipoPermissãoEspelhaO que faz
banking_charge_pix_account_listreadcharge.pix_accounts.basicGET /v2/charge/pix_accountsLists the Pix accounts of the account (the provider account and Pix key that receive Pix charges), most recent first, with their status.
banking_charge_pix_account_getreadcharge.pix_accounts.basicGET /v2/charge/pix_accounts/:uidReturns every field of one Pix account (provider, key, status, beneficiary, financial account), in the same shape as the API v2.
banking_charge_pix_account_createdestructivecharge.pix_accounts.createPOST /v2/charge/pix_accountsRegisters a Pix account: the provider account and Pix key that will receive the account's Pix charges.
banking_charge_pix_account_updatedestructivecharge.pix_accounts.updatePATCH /v2/charge/pix_accounts/:uidChanges a Pix account: name, enabled flag, default flag, Pix key or financial account.
banking_charge_pix_account_deletedestructivecharge.pix_accounts.destroyDELETE /v2/charge/pix_accounts/:uidDeletes a Pix account together with its Pix charges.

Pix Automático — contas​

Escopo: banking/charge.automatic_pix.accounts

ToolTipoPermissãoEspelhaO que faz
banking_charge_automatic_pix_account_listreadcharge.automatic_pix.accounts.basicGET /v2/charge/automatic_pix/accountsLists the Pix Automático receiving accounts of the account, most recent first, with their status (pending, inactive or active).
banking_charge_automatic_pix_account_getreadcharge.automatic_pix.accounts.basicGET /v2/charge/automatic_pix/accounts/:uidReturns every field of one Pix Automático receiving account (financial account, connection, provider, status), in the same shape as the API v2.
banking_charge_automatic_pix_account_createwritecharge.automatic_pix.accounts.createPOST /v2/charge/automatic_pix/accountsRegisters a Pix Automático receiving account on a financial account of the account.
banking_charge_automatic_pix_account_updatedestructivecharge.automatic_pix.accounts.updatePATCH /v2/charge/automatic_pix/accounts/:uidChanges a Pix Automático receiving account: name, external id, tags, custom data or the enabled flag.
banking_charge_automatic_pix_account_deletedestructivecharge.automatic_pix.accounts.destroyDELETE /v2/charge/automatic_pix/accounts/:uidDeletes a Pix Automático receiving account.

Pix Automático — recorrências​

Escopo: banking/charge.automatic_pix.recurrences

ToolTipoPermissãoEspelhaO que faz
banking_charge_automatic_pix_recurrence_listreadcharge.pix.basicGET /v2/charge/automatic_pix/recurrencesLists the Pix Automático recurrences (payer authorizations for recurring debits) of the account, most recent first, with their provider status.
banking_charge_automatic_pix_recurrence_getreadcharge.pix.basicGET /v2/charge/automatic_pix/recurrences/:uidReturns every field of one Pix Automático recurrence (debtor, terms, provider status, QR code, requests, cancellation or rejection), in the same shape as the API v2.
banking_charge_automatic_pix_recurrence_createwritecharge.pix.createPOST /v2/charge/automatic_pix/recurrencesCreates a Pix Automático recurrence: the terms (cycle, amount, dates, retry policy) under which a debtor will authorize recurring Pix debits to a Pix Automático account.
banking_charge_automatic_pix_recurrence_updatewritecharge.pix.updatePATCH /v2/charge/automatic_pix/recurrences/:uidChanges the Kobana-side data of a recurrence (external id, tags, custom data).
banking_charge_automatic_pix_recurrence_command_updatewritecharge.pix.updatePUT /v2/charge/automatic_pix/recurrences/:uid/updateChanges a registered recurrence at the provider: its charge Pix, location, start date or debtor name.
banking_charge_automatic_pix_recurrence_command_canceldestructivecharge.pix.cancelPUT /v2/charge/automatic_pix/recurrences/:uid/cancelAsks the provider to cancel a registered recurrence, so no further Pix Automático charges can be debited under it.

Pix Automático — solicitações​

Escopo: banking/charge.automatic_pix.requests

ToolTipoPermissãoEspelhaO que faz
banking_charge_automatic_pix_request_listreadcharge.pix.basicGET /v2/charge/automatic_pix/requestsLists the Pix Automático authorization requests of the account (sent to the debtor's bank for a recurrence), most recent first, with their provider status.
banking_charge_automatic_pix_request_getreadcharge.pix.basicGET /v2/charge/automatic_pix/requests/:uidReturns every field of one Pix Automático authorization request (debtor account, provider status, rejection or cancellation), in the same shape as the API v2.
banking_charge_automatic_pix_request_createwritecharge.pix.createPOST /v2/charge/automatic_pix/recurrences/:recurrence_uid/requestsCreates an authorization request for a registered recurrence, addressed to the debtor's bank account: the debtor approves or rejects the recurring debits in their bank's app.
banking_charge_automatic_pix_request_updatewritecharge.pix.updatePATCH /v2/charge/automatic_pix/requests/:uidChanges the Kobana-side data of an authorization request (external id, tags, custom data).
banking_charge_automatic_pix_request_command_canceldestructivecharge.pix.cancelPUT /v2/charge/automatic_pix/requests/:uid/cancelAsks the provider to cancel an authorization request, so the debtor can no longer approve it.

Pix Automático — cobranças​

Escopo: banking/charge.automatic_pix.pix

ToolTipoPermissãoEspelhaO que faz
banking_charge_automatic_pix_pix_listreadcharge.pix.basicGET /v2/charge/automatic_pix/pixLists the Pix Automático charges (scheduled debits under authorized recurrences) of the account, most recent first, with their provider status.
banking_charge_automatic_pix_pix_getreadcharge.pix.basicGET /v2/charge/automatic_pix/pix/:uidReturns every field of one Pix Automático charge (amount, date, provider status, retries, received payments, cancellation or rejection), in the same shape as the API v2.
banking_charge_automatic_pix_pix_createdestructivecharge.pix.createPOST /v2/charge/automatic_pix/recurrences/:recurrence_uid/pixSchedules a Pix Automático charge: a debit from the debtor's account on expire_at, under a recurrence the debtor already authorized.
banking_charge_automatic_pix_pix_updatewritecharge.pix.updatePATCH /v2/charge/automatic_pix/pix/:uidChanges the Kobana-side data of a Pix Automático charge (external id, tags, custom data).
banking_charge_automatic_pix_pix_command_canceldestructivecharge.pix.cancelPUT /v2/charge/automatic_pix/pix/:uid/cancelAsks the provider to cancel a scheduled Pix Automático charge, so the debtor is not debited.
banking_charge_automatic_pix_pix_command_retrydestructivecharge.pix.updatePUT /v2/charge/automatic_pix/pix/:uid/retrySchedules a new debit attempt of a Pix Automático charge that is active, expired or rejected at the provider, on a future date.

Pix Automático — locations​

Escopo: banking/charge.automatic_pix.locations

ToolTipoPermissãoEspelhaO que faz
banking_charge_automatic_pix_location_listreadcharge.pix.basicGET /v2/charge/automatic_pix/locationsLists the Pix Automático locations of the account (the provider URLs a recurrence QR code points to), most recent first.
banking_charge_automatic_pix_location_getreadcharge.pix.basicGET /v2/charge/automatic_pix/locations/:uidReturns every field of one Pix Automático location, including the provider URL once it is registered, in the same shape as the API v2.
banking_charge_automatic_pix_location_createwritecharge.pix.createPOST /v2/charge/automatic_pix/locationsCreates a Pix Automático location on a Pix Automático account.

Os campos de cada recurso estão na Referência da API. Uma tool que você não pode rodar não aparece em tools/list; se uma daqui não está lá, veja Autenticação.