Consultar cobrança
Busca uma cobrança pelo código público ch_….
404 não distingue “não existe” de “existe, mas é de outra conta”. Responder a diferença
confirmaria a existência de cobranças alheias a quem tentasse adivinhar códigos.Authorizations
Chave secreta do vendedor, criada no painel em Desenvolvedores.
O valor em claro existe uma única vez, na criação. Guardamos só o hash SHA-256 - nem o suporte consegue recuperá-lo, o que é o ponto: um dump do nosso banco não permite cobrar em nome de ninguém.
A chave vai no servidor. Colocá-la no navegador do comprador a entrega a qualquer pessoa que abra a página.
Path Parameters
Código público da cobrança, no formato ch_….
^ch_[0-9a-z]{26}$Response
A cobrança.
"charge"Código público da cobrança. Nunca é a chave primária: expor o autoincremento diria a qualquer cliente quantas vendas a plataforma inteira processou.
"ch_01k1y6r6m6q2x0p3d9v4t7c8n2"
Situação da cobrança. Todos os estados exceto pending são
terminais - exceto os que ainda admitem estorno.
partially_refunded é estado próprio, e não um refunded com
asterisco: tratar uma venda devolvida pela metade como estornada
faria seu relatório descontar o valor inteiro.
pending, paid, expired, canceled, partially_refunded, refunded, failed pix Valor cobrado, em centavos inteiros.
"BRL"Nossa taxa, em centavos inteiros. Congelada na criação: reflete o contrato que valia quando a venda aconteceu, não o de hoje.
O que fica com o vendedor, em centavos inteiros
(amount - platform_fee).
Total já devolvido ao comprador, em centavos inteiros. Acumulado entre estornos parciais.
O comprador, como devolvemos.