---
title: "Renew a subscription"
method: POST
path: "/payments/subscriptions/{id}/renew"
tags: ["Payments"]
---

# Renew a subscription

`POST /payments/subscriptions/{id}/renew`

Renews a single subscription period: the facilitator settles the period charge on-chain and advances the current period end.

## Path parameters

- `id` string, required

## Request body

- object
  - `paymentAuthorization` string, required — Base64 Ed25519 signature of the standing `upto` authorization the subscriber signed at creation. Verified against the standing authorization message (never a per-period nonce); used to settle this period's charge.
  - `settledAmount` string — Optional actual amount to settle this period in base units (integer string), bounded by the plan amount. Defaults to the plan's per-period charge.

## Response `200`

OK

- object

---

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