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

# Create a manual subscription payment

`POST /v1/subscription-payments`

## Request

- Base URL: `https://api.payretailers.com`
- URL: `https://api.payretailers.com/v1/subscription-payments`
- Auth: HTTP basic

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.dev/payretailers/apis/subscriptions-module-api.md) - [All operations](https://skmtc.dev/payretailers/apis/subscriptions-module-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payretailers/apis/subscriptions-module-api/revisions/dd2464c871f8?raw)