purchase_credits
Idempotent
Purchase organization-bound prepaid service credits in USD cents. Requires billing scope and an idempotency key. A live 402 response returns an MPP card-payment challenge; retry the same purchase/key with payment_authorization separately from the account Bearer token. Authenticated provider confirmation credits the balance exactly once. Sandbox purchases are simulated. Cards are supported; stablecoins are not enabled.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| automatic | No | Use a previously recorded bounded funding mandate; false for an ordinary one-time purchase. | |
| amount_cents | Yes | Purchase amount in USD cents, from 50 ($0.50) to 100000 ($1000); live account spending and launch limits also apply. | |
| idempotency_key | Yes | Caller-generated key, 8–128 letters, digits, underscores, dots, colons or hyphens. Reuse for retries of the same purchase or operation. Different input with the same organization-bound key returns a conflict. | |
| payment_authorization | No | MPP card authorization responding to this purchase's payment_challenge. Omit on the first call; never place the account Bearer token here. |