---
title: "Create a new subscription with credit card details"
method: POST
path: "/v3/subscriptions"
tags: ["Subscriptions"]
---

# Create a new subscription with credit card details

`POST /v3/subscriptions`

This endpoint allows PCI merchants to create a new subscription with direct credit card details.

## Headers

- `Content-Type` string, required
- `X-Date` string, date-time, required
- `X-Login` string, required
- `Authorization` string, required
- `X-Idempotency-Key` string

## Request body

- SubscriptionRequestPCI
  - `invoice_id` string, required — Unique identifier for the invoice
  - `amount` number, double, required — Amount to be charged for the subscription
  - `currency` string, required — Three-letter currency code (ISO 4217)
  - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2)
  - `payer` Payer, required
    - `id` string, required — Unique identifier for the payer
    - `document` string, required — Payer's identification document number
    - `document_type` string, required — Type of identification document
    - `email` string, email, required — Payer's email address
    - `first_name` string, required — Payer's first name
    - `last_name` string, required — Payer's last name
  - `description` string — Description of the subscription
  - `subscription` SubscriptionDetails, required
    - `start_date` string, date, required — Date when the subscription should start (YYYY-MM-DD)
    - `plan` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'ANNUALLY', required — Frequency of the subscription (DAILY, WEEKLY, MONTHLY, ANNUALLY)
    - `plan_unit` integer, required — Number of plan units (e.g., 1 for monthly, 3 for quarterly)
    - `auto_renewal` boolean — Whether the subscription should automatically renew
  - `credit_card` CreditCard, required
    - `cvv` string, required — Card Verification Value
    - `card_number` string, required — Credit card number
    - `expiration_month` string, required — Expiration month (MM)
    - `expiration_year` string, required — Expiration year (YY)
    - `holder_name` string, required — Name of the card holder
  - `client_ip` string — IP address of the client
  - `back_url` string, uri — URL to redirect after payment process
  - `success_url` string, uri — URL to redirect after successful payment
  - `error_url` string, uri — URL to redirect after failed payment
  - `notification_url` string, uri — URL to send payment status notifications

## Response `200`

Subscription created successfully

- object
  - `subscription_id` integer — Unique identifier of the created subscription

## Other responses

- `400` — Bad Request - Invalid input data
- `422` — Unprocessable Entity - Validation error
- `503` — Service Unavailable - Error creating subscription

---

[API](https://skmtc.net/d24/apis/docs-d24-com.md) · [All operations](https://skmtc.net/d24/apis/docs-d24-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d24/docs-d24-com/versions/fb0e2ddec198/schema)