Pular para o conteúdo principal
PUT
Atualizar dados de cobrança
Os dados de cobrança são usados nos recibos e nas faturas, e um pedido precisa deles completos. A requisição substitui os dados salvos. Ela carrega dados pessoais (nome, endereço e CPF/CNPJ), então envie somente valores fornecidos pelo titular da conta.
string
obrigatório
O nome que aparece nos recibos e nas faturas.
object
obrigatório
string | null
Número de telefone opcional, no formato E.164, por exemplo +5585999990000. null ou omitido remove o telefone salvo.
object | null
O CPF ou CNPJ. Obrigatório no Brasil para que os dados fiquem completos. null remove o documento salvo; omitir o campo mantém o documento.
Fora do Brasil, line1, city e postal_code são suficientes.

Resposta

Os dados salvos, com o documento mascarado, e complete. Veja Obter dados de cobrança para os campos. A resposta nunca é armazenada em cache.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: o cabeçalho Authorization não foi enviado, a chave de API é inválida ou a sessão do dashboard foi revogada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: a chave de API foi usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (403).
  • USER_NOT_FOUND: o usuário autenticado não foi encontrado.
  • BILLING_DETAILS_INVALID: um campo falhou na validação; o nome dele está em details.path (400).
  • TAX_ID_INVALID: o CPF ou CNPJ não é válido (400).
  • PAYMENT_METHOD_UNAVAILABLE: o pagamento online está temporariamente indisponível (400).
  • INTERNAL_SERVER_ERROR: ocorreu um erro inesperado no servidor.
Última modificação em 28 de outubro de 2026