---
title: "Grant USD credit that Stripe applies to this organization's future invoices."
method: POST
path: "/admin/v1/billing/credits/grant"
tags: ["billing"]
---

# Grant USD credit that Stripe applies to this organization's future invoices.

`POST /admin/v1/billing/credits/grant`

## Request body

- GrantAccountCreditRequest — Request body for granting an organization future Stripe invoice credit.
  - `amount_cents` integer, required — Positive USD amount in cents.
  - `issued_by` string, required
  - `operator_message` string, required
  - `org_id` string, uuid, required
  - `reference` string, required — Stable support/ticket reference used to make retries idempotent.

## Response `200`

Credit granted

- AccountCreditTransaction — Stripe's immutable customer-balance transaction, normalized as positive credit.
  - `amount_cents` integer, required
  - `available_credit_cents` integer, required
  - `created_at` string, date-time, required
  - `currency` string, required
  - `id` string, required
  - `stripe_customer_id` string, required

## Other responses

- `400` — Invalid credit grant
- `401` — Invalid operator credential
- `404` — Organization or billing configuration not found
- `502` — Billing provider unavailable

---

[API](https://skmtc.dev/microsandbox/apis/microsandbox-api.md) · [All operations](https://skmtc.dev/microsandbox/apis/microsandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microsandbox/microsandbox-api/revisions/23f2a45cb09b/schema)