---
title: "Cria um plano de assinatura para um produto"
method: POST
path: "/v1/products/{productId}/plans"
tags: ["Plans"]
---

# Cria um plano de assinatura para um produto

`POST /v1/products/{productId}/plans`

## Request

- Base URL: `https://api.sandbox.mupag.com.br`
- URL: `https://api.sandbox.mupag.com.br/v1/products/{productId}/plans`
- Auth: HTTP bearer

## Path parameters

- `productId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreatePlanRequest
  - `name` string, required
  - `description` string
  - `amount_cents` integer, required
  - `billing_period_unit` string, required
  - `billing_period_interval` integer, required
  - `trial_days` integer
  - `setup_fee_cents` integer

## Response `201`

Plano criado

- PlanResponse
  - `id` string, uuid, required
  - `product_id` string, uuid, required
  - `merchant_id` string, uuid, required
  - `environment` string, required
  - `name` string, required
  - `description` string
  - `amount_cents` integer, required
  - `currency` string, required
  - `billing_period_unit` string, required
  - `billing_period_interval` integer, required
  - `trial_days` integer, required
  - `setup_fee_cents` integer, required
  - `status` string, required
  - `first_subscription_at` string, date-time
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `archived_at` string, date-time

## Other responses

- `400`: Erro de validação
- `401`: Falha de autenticação
- `403`: Permissão insuficiente
- `409`: Conflito de idempotência ou estado
- `422`: Erro de validação

---

[API](https://skmtc.dev/mupag/apis/mupag-public-merchant-api.md) · [All operations](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/revisions/677904516d2d?raw)