---
title: "Charge Subscription"
method: POST
path: "/v1/subscriptions/{id}/charge"
tags: ["Subscriptions"]
---

# Charge Subscription

`POST /v1/subscriptions/{id}/charge`

The following endpoint activates a subscription with its first charge, or updates the customer's stored payment method.

## Path parameters

- `id` string, required

## Headers

- `Content-Type` string, required
- `X-Request-ID` string

## Request body

- object
  - `payment_method_unique_id` 'SHOPEEPAY', required — Binding reference for the customer's bound payment method.

## Response `200`

Charge executed, or payment method updated (no charge).

- object
  - `status` string
  - `data` object

## Other responses

- `402` — The auto-debit charge was declined by the payment provider.
- `404` — No subscription with the given id exists for this merchant.
- `409` — The current billing cycle has already been charged with this payment method.
- `422` — The subscription is in a state that cannot be charged.

---

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