---
title: "Create a manual subscription payment"
method: POST
path: "/v1/subscription-payments"
tags: ["SubscriptionPayment"]
---

# Create a manual subscription payment

`POST /v1/subscription-payments`

Creates a manual payment for a subscription. Used when automatic scheduling is not enabled.

## Request body

- SubscriptionPaymentRequest
  - `subscriptionId` string, uuid, required — Unique identifier of the subscription
  - `payDate` string, date, required — Payment date in format yyyy-MM-dd. For PIX: must be 2-10 days in the future.
  - `amount` integer, required — Payment amount in cents. Must respect subscription limits.
  - `internalReferenceId` string, required — Your internal reference ID for this payment
  - `description` string, nullable — Description of the payment

## Response `201`

Payment created successfully

- SubscriptionPaymentCreationResponse
  - `subscriptionPaymentId` string, uuid — Unique identifier for the created payment
  - `status` string — Initial payment status

## Other responses

- `400` — Bad Request

---

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