---
title: Saldo e compras
description: >-
  Recargas, sua tarifa, como uma compra é precificada e o que acontece com o
  saldo.
sidebar:
  order: 5
---
## Recargas [#top-ups]

Adicione saldo na [página Desenvolvedores](https://trimcarbon.com/developers/access), pelo Stripe Checkout. Cada recarga vai de US$ 250 a US$ 10.000, e o saldo não pode passar de US$ 50.000. Para valores maiores, fale com a gente: podemos emitir uma fatura para você.

Você recebe uma fatura para cada recarga. O valor entra no saldo assim que o Stripe confirma o pagamento.

## Sua tarifa [#your-rate]

Sua tarifa é um preço por kg de CO₂, mostrado na página Desenvolvedores e em `GET /balance` como `rate_millicents_per_kg` (milésimos de centavo): `4000` equivale a US$ 0,04 por kg, ou US$ 40 por tonelada.

## Como uma compra é precificada [#how-a-purchase-is-priced]

- **Por volume:** `{"kg": 1000}` custa `kg × rate`, arredondado para o centavo. A US$ 0,04/kg, isso dá US$ 40,00.
- **Por preço:** `{"amount_cents": 5000}` compra a maior quantidade de kg inteiros cujo custo cabe no valor e cobra esse custo, nunca mais que o valor. A US$ 0,035/kg, US$ 50,00 compram 1.428 kg por US$ 49,98.

Use `POST /quotes` para ver os dois números antes de comprar.

Uma compra que o saldo não cobre falha com `402 insufficient_balance`, e nada é comprado. O erro informa o saldo e o custo.

## Compras grandes [#large-purchases]

Cada conta tem um limite de revisão, de 15 t por padrão. Uma compra acima dele é aceita e paga com o saldo, mas aguarda nossa revisão antes que os créditos sejam aposentados. `POST /quotes` avisa você com `requires_review`.

## Se um pedido não puder ser feito [#if-an-order-cant-be-placed]

Quando um pedido falha, tentamos de novo para você. Se ele ainda assim não puder ser feito, devolvemos o custo dele ao seu saldo, e o status da compensação passa a ser `refunded`.

## E-mail de saldo baixo [#low-balance-email]

Defina um limite na página Desenvolvedores. Enviamos um e-mail uma vez quando uma compra deixa o saldo abaixo dele. Depois que uma recarga eleva o saldo acima do limite, a próxima queda abaixo dele gera um novo e-mail.

## Termos [#terms]

O saldo é pré-pago e **não reembolsável**. Ele não expira. Só pode ser usado para pagar compras pela API, e você o perde se excluir sua conta. Os [termos](https://trimcarbon.com/legal/terms-and-conditions#api) trazem os detalhes.