---
title: "POST /subscription/merchant/one-time-charge"
method: POST
path: "/subscription/merchant/one-time-charge"
---

# POST /subscription/merchant/one-time-charge

`POST /subscription/merchant/one-time-charge`

Charge a one-time amount against an existing subscription using its saved payment method.

## Headers

- `Idempotency-Key` string

## Request body

- SubsOneTimeCharge
  - `subscriptionId` string, required — Unique identifier of the subscription to charge against. The subscription's saved payment method will be used for this charge.
  - `amount` integer, required — The amount in lowest count unit. e.g.: For USD 1, amount is 100 representing 100 cents. Must be within the currency's supported minimum and maximum bounds.
  - `currency` string, required — Three letter abbreviation of the currency. Refer [supported currencies](/get-started/currencies-supported)
  - `comments` string — Optional free-form note describing the reason for this one-time charge.

## Response `200`

Subscription One Time Charge response

- SubsOneTimeChargeResponse
  - `intentId` string — Unique identifier of the payment intent created for this one-time charge.
  - `status` string — The status of the payment intent. Refer [payment intent status](/products/one-time-payments/payment-statuses)
  - `errorCode` string, nullable — Machine readable failure reason when status is `FAILED`. `null` on a successful charge. [See all possible values here.](/products/one-time-payments/error-codes)
  - `errorMessage` string, nullable — Human readable description of the failure reason when the charge was not successful. `null` on a successful charge.

## Other responses

- `400` — unexpected error

---

[API](https://skmtc.net/xpaycheckout/apis/xpay-api-store.md) · [All operations](https://skmtc.net/xpaycheckout/apis/xpay-api-store/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xpaycheckout/xpay-api-store/versions/6329a7c694bc/schema)