curl --request DELETE \
--url https://api.sandbox.z2pay.com/v1/pix-authorizations/{id} \
--header 'x-api-key: <api-key>'const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.z2pay.com/v1/pix-authorizations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sandbox.z2pay.com/v1/pix-authorizations/{id}"
headers = {"x-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text){
"id": "pxa_j43n74fbt2geb8c1y86ssf6iw",
"customerId": "cust_hqx4mkpi8dcxbrb2nzynxnjky",
"subscriptionId": "sub_m4n6b8v0c2x4z6a8s0d2f4g6h",
"status": "canceled",
"frequency": "monthly",
"recurrenceBeginningDay": "2026-09-01",
"endDay": null,
"createdAt": "2026-08-31T14:22:05.000Z",
"updatedAt": "2026-08-31T14:24:40.000Z"
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"error": {
"code": "CONFLICT",
"message": "No refundable payment found"
}
}{
"error": "Idempotency key already used with a different request body"
}Encerrar autorização
Encerra a autorização de Pix Automático no banco do pagador — as faturas seguintes deixam de ir a débito e passam a ser pagas pelo link.
curl --request DELETE \
--url https://api.sandbox.z2pay.com/v1/pix-authorizations/{id} \
--header 'x-api-key: <api-key>'const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.z2pay.com/v1/pix-authorizations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sandbox.z2pay.com/v1/pix-authorizations/{id}"
headers = {"x-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text){
"id": "pxa_j43n74fbt2geb8c1y86ssf6iw",
"customerId": "cust_hqx4mkpi8dcxbrb2nzynxnjky",
"subscriptionId": "sub_m4n6b8v0c2x4z6a8s0d2f4g6h",
"status": "canceled",
"frequency": "monthly",
"recurrenceBeginningDay": "2026-09-01",
"endDay": null,
"createdAt": "2026-08-31T14:22:05.000Z",
"updatedAt": "2026-08-31T14:24:40.000Z"
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"error": {
"code": "CONFLICT",
"message": "No refundable payment found"
}
}{
"error": "Idempotency key already used with a different request body"
}DELETE /pix-authorizations/:id
Faz parte do recurso Pix Automático — quem mais pode encerrar uma
autorização, e como você fica sabendo, está lá.
Encerra a autorização primeiro no banco do pagador e depois do nosso lado, e ela passa a canceled.
Nenhuma fatura seguinte vai a débito: a assinatura continua, e as renovações passam a ser enviadas
ao pagador por e-mail, com o link para pagar por Pix. Você também recebe o webhook
pix_authorization.canceled.
409 e nada muda. A autorização
continua active e as faturas continuam indo a débito. Tente de novo.200. Uma autorização canceled ou expired volta
com o estado dela, sem nova chamada ao banco — repetir a requisição é seguro.maxCycles) ou trocar a forma de
pagamento dela também encerra a autorização. Nesses casos você não precisa chamar esta rota.Exemplo
curl -X DELETE https://api.sandbox.z2pay.com/v1/pix-authorizations/pxa_j43n74fbt2geb8c1y86ssf6iw \
-H "x-api-key: SUA_CHAVE_DE_SANDBOX"
{
"id": "pxa_j43n74fbt2geb8c1y86ssf6iw",
"customerId": "cust_hqx4mkpi8dcxbrb2nzynxnjky",
"subscriptionId": "sub_m4n6b8v0c2x4z6a8s0d2f4g6h",
"status": "canceled",
"frequency": "monthly",
"endDay": null,
"createdAt": "2026-08-31T14:22:05.000Z",
"updatedAt": "2026-08-31T14:24:40.000Z"
}
Authorizations
API Key da Credential (gerada no Backoffice)
Path Parameters
ID da autorização (pxa_)
Response
Autorização encerrada
ID da autorização (pxa_).
Cliente pagador (cust_). Na resposta da abertura vem nulo quando o pagador foi enviado em customer: o vínculo é preenchido logo depois, e o GET já o traz.
Assinatura que usa esta autorização como forma de pagamento. Nulo até a assinatura ser criada — e para sempre numa autorização que nunca virou assinatura.
Situação da autorização: pending, active, canceled ou expired. canceled e expired são finais.
pending, active, canceled, expired Periodicidade que o pagador autorizou: weekly, monthly, quarterly, semiannual ou annual. Precisa ser a mesma da assinatura.
weekly, monthly, quarterly, semiannual, annual Primeiro dia em que o débito pode acontecer (YYYY-MM-DD), no calendário da sua conta. Na abertura pela API é o dia seguinte — o primeiro pagamento sai na hora, pelo QR.
Último dia de validade (YYYY-MM-DD), resolvido a partir do endDate enviado. Nulo quando a autorização vale até ser encerrada.
Criação, ISO 8601.
Última alteração, ISO 8601.