---
title: "Setup drawdown billing"
method: POST
path: "/api/v1/billing/drawdown"
tags: ["Billing"]
---

# Setup drawdown billing

`POST /api/v1/billing/drawdown`

Set up or update drawdown billing for the authenticated developer

## Request body

- SetupDrawdownParams
  - `chargeAutomatically` boolean — Whether to automatically charge the invoice when created. Defaults to true if not specified.
  - `minBalanceSubunits` integer, required — Minimum balance threshold in smallest currency unit (e.g. cents). A top-up is triggered when balance falls below this value.
  - `targetBalanceSubunits` integer, required — Target balance in smallest currency unit (e.g. cents). When balance drops below minBalanceSubunits, a top-up invoice is created to replenish to this amount.

## Response `200`

Updated billing configuration

- BillingResponse
  - `drawdown` object, required
    - `balance` Money, required
      - `currencyCode` string, required
      - `amountSubunits` integer, required
    - `config` object, nullable, required
      - `chargeAutomatically` boolean, required
      - `currency` string, required
      - `minBalanceSubunits` number, double, required
      - `targetBalanceSubunits` number, double, required
    - `enabled` boolean, required

## Other responses

- `401` — Authentication Failed
- `422` — Validation Error

---

[API](https://skmtc.dev/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.dev/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/revisions/175c7f9e090e/schema)