---
title: "Charge Now"
method: POST
path: "/subscription/api/v1/subscriptions/{id}/charge-now"
tags: ["Subscription Charge"]
---

# Charge Now

`POST /subscription/api/v1/subscriptions/{id}/charge-now`

This endpoint immediately triggers the next scheduled recurring charge for a subscription without waiting for the next billing cycle.

> **Note:** This endpoint charges the subscription's configured plan amount immediately and advances the billing cycle if the charge is successful.

## Path parameters

- `id` string, required

## Request body

- ChargeSubscriptionNowRequest
  - `idempotencyKey` string, required — A unique key used to prevent duplicate charge requests.

## Response `200`

Charge Subscription Now Responses

- ChargeSubscriptionNowResponse
  - `success` boolean — Indicates if the request was successful.
  - `message` string — Descriptive message regarding the charge operation.
  - `data` object — The payload containing the charge result or the next action details.
    - `status` string — The status of the charge (e.g., **SUCCESS** or **REQUIRES_ACTION**).
    - `transactionReference` string — Unique reference for this charge transaction.
    - `three_ds_url` string — The 3D Secure URL to redirect the customer to. *(Returned only if status is REQUIRES_ACTION)*.
    - `three_ds_html` string — The 3D Secure HTML form to render for authentication. *(Returned only if status is REQUIRES_ACTION)*.
    - `amount` number — The charged amount. *(Returned only if status is SUCCESS)*.
    - `currency` string — The 3-letter ISO currency code. *(Returned only if status is SUCCESS)*.
    - `chargeMode` string — The mode of the charge. *(Returned only if status is SUCCESS)*.
    - `message` string — Additional status message from the gateway. *(Returned only if status is SUCCESS)*.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)