Billing
Update Billing Details
Replaces the billing details of the account. Requires the billing:write scope.
PUT
Update Billing Details
Billing details are used on receipts and invoices, and an order needs them complete. The request
replaces the saved details. It carries personal data (name, address and CPF/CNPJ), so only send
values the account owner provided.
Outside Brazil,
Optional phone number, in E.164 format, for example
+5585999990000. null or omitted removes
the saved phone.The CPF or CNPJ. Required in Brazil for the details to be complete.
null removes the saved
document; omitting the field keeps it.line1, city and postal_code are enough.
Response
The saved details, with the document masked, andcomplete. See
Get Billing Details for the fields. The
response is never cached.
Error Responses
The error code indicating the reason for failure. Possible values:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: TheAuthorizationheader is missing, the API key is invalid, or the dashboard session was revoked (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: The API key is used from an IP outside its allowlist, or it lacks the scope the route requires (403).USER_NOT_FOUND: The authenticated user was not found.BILLING_DETAILS_INVALID: A field failed validation; its name is indetails.path(400).TAX_ID_INVALID: The CPF or CNPJ is not valid (400).PAYMENT_METHOD_UNAVAILABLE: Online payment is temporarily unavailable (400).INTERNAL_SERVER_ERROR: An unexpected server error occurred.
Last modified on October 26, 2026