Cancelar cobrança (painel)
Cancela uma cobrança aguardando pagamento. Papéis: owner, admin, billing.
POST
/payments/v1/orgs/{orgId}/charges/{id}/cancel Exige Authorization: Bearer com o token de login.
Parâmetros de caminho
orgIduuidobrigatórioiduuidobrigatório
Respostas
200OK
{
"id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f",
"status": "pending",
"amountCents": 1990,
"currency": "BRL",
"description": "Primeiro projeto na Onny.",
"externalReference": "pedido-42",
"pixCode": "texto",
"pixQrBase64": "texto",
"payUrl": "texto",
"methods": [
"pix",
"card"
],
"cardCheckoutUrl": "https://www.mercadopago.com.br/checkout/v1/redirect?pref_id=…",
"paidWith": null,
"mode": "live",
"expiresAt": "2026-10-11T12:00:00+00:00",
"paidAt": null,
"createdAt": "2026-10-11T12:00:00+00:00",
"failureReason": "texto"
}17 campos descrição de cada um
iduuidId da cobrança.
statusstringcreating, pending, paid, expired, canceled, refunded ou failed.
amountCentsintegerValor em centavos.
currencystringMoeda (BRL).
descriptionstringDescrição.
externalReferencestring | nullSua referência.
pixCodestring | nullPix copia-e-cola.
pixQrBase64string | nullQR Code (PNG em base64).
payUrlstringPágina de pagamento da Onny para enviar ao pagador (mostra o Pix e/ou o botão de cartão).
methodsstring[]Formas aceitas (pix, card).
cardCheckoutUrlstring | nullPágina de cartão do Mercado Pago (se aceita cartão). Prefira enviar o PayUrl.
paidWithstring | nullComo foi paga: pix ou card.
modestringlive ou test.
expiresAtdatetimeVence em.
paidAtdatetime | nullPaga em.
createdAtdatetimeCriada em.
failureReasonstring | nullMotivo da falha, se houver.
401Unauthorized
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "Unauthorized",
"status": 401,
"detail": "Mensagem legível para pessoas.",
"code": "Unauthorized",
"traceId": "00-4bf9…-01"
}403Forbidden
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 403,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}404Not Found
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 404,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}409Conflict
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 409,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}503Service Unavailable
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 503,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}