---
title: "Charge a merchant-initiated subscription on demand"
method: POST
path: "/subscriptions/{id}/charge"
tags: ["Subscriptions"]
---

# Charge a merchant-initiated subscription on demand

`POST /subscriptions/{id}/charge`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

## Path parameters

- `id` number, required

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Request body

- ChargeSubscriptionDto
  - `amount` number, required: In the smallest currency unit (e.g. 100 cents to charge €1.00).
  - `currency` string, required
  - `reference` string, required: Your idempotency key — retrying with the same reference and the same amount on the same subscription never charges twice. Retry with the same reference and amount after a timeout or 5xx; the same reference with a different amount is refused with 409.

## Response `200`

- SubscriptionChargeResponseDto
  - `id` number, required
  - `status` 'pending' | 'success' | 'failed', required
  - `amount` string, required: Decimal string in major currency units, e.g. "1500.00".
  - `transactionDate` string, date-time, required
  - `cybersourceReference` object, nullable, required: Null while the charge is still pending confirmation from Cybersource.
  - `merchantReference` object, nullable, required: The reference sent when triggering this charge.
  - `indicator` 'CIT' | 'MIT', required
  - `createdAt` string, date-time, required

## Other responses

- `400`: Bad Request
- `401`: Wrong credentials
- `403`: Forbidden
- `404`: Not Found
- `409`: Invalid request
- `500`: Internal error
- `503`: Service unavailable

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/subscriptions/:id/charge/post.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)