---
title: "Histórico"
description: "Pedidos, pagamentos, assinaturas, saques e cobranças."
---
Depois da compra, o storefront precisa mostrar o que aconteceu. O Cinderace separa esse histórico por domínio: pedidos, pagamentos, assinaturas, saques e cobranças.

## Pedidos

```ts
const order = await sdk.orders.getOrder("payment-id");
const bonds = await sdk.orders.getBonds("payment-id");
```

`getOrder` traz status, método, valores, itens e instruções de pagamento.

## Pagamentos

```ts
const payments = await sdk.payments.listHistory({
    page: 1,
    perPage: 20
});

const shipping = await sdk.payments.getShipping("payment-uuid");
```

## Assinaturas

```ts
const subscriptions = await sdk.subscriptions.listSubscriptions();
const subscription = await sdk.subscriptions.getSubscription("subscription-id");
const payments = await sdk.subscriptions.getPayments("subscription-id");

await sdk.subscriptions.cancelSubscription("subscription-id");
await sdk.subscriptions.renewSubscription("subscription-id");
```

## Saques

```ts
const withdrawals = await sdk.withdrawals.listWithdrawals();
const summary = await sdk.withdrawals.getSummary();
const methods = await sdk.withdrawals.listMethods();
const cooldown = await sdk.withdrawals.getCooldown();

// O body é um union de etapas (solicitação e confirmação).
// Veja os campos exatos na referência de withdrawals.
await sdk.withdrawals.requestWithdraw(body);
```

## Cobranças

```ts
const attempts = await sdk.billing.listAttempts({
    page: 1,
    perPage: 20,
    status: "PENDING"
});
```

## Minha conta

```ts
const profile = await sdk.user.getProfile();
const balance = await sdk.user.getBalanceHistory({ page: 1 });
const library = await sdk.user.getDigitalLibrary();
```

:::note[Paginação]
Os endpoints de histórico usam `page`/`perPage` ou `page`/`limit`, conforme o schema da rota. O autocomplete mostra os campos exatos.
:::