---
title: "Teste - Criar assinatura avulsa"
method: POST
path: "/subscriptions2"
---

# Teste - Criar assinatura avulsa

`POST /subscriptions2`

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/subscriptions2`
- Auth: HTTP basic

Fornecemos a possibilidade de criação de uma assinatura (`subscription`) sem a necessidade de criação de um plano (`plan`).

## Request body

- object
  - `payment_method` string, required: Meio de pagamento.<br>Valores possíveis: **credit_card**, **boleto** e **debit_card** .
  - `card` object[]: Cartão <br>**- card_id** é o código do cartão do cliente.<br>**- card_token** é token do cartão gerado pelo checkout transparente. <br> É **obrigatório** o envio de uma dessas identificações, caso o **payment_method** seja credit_card ou debit_card.<br>[Saiba mais sobre cartões](https://docs.pagar.me/v5/reference#cart%C3%B5es).
    - `number` string, required: Número do cartão. Entre 13 e 19 caracteres
    - `holder_name` string, required: Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
    - `holder_document` string: CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
    - `exp_month` integer, required: Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
    - `exp_year` integer, required: Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
    - `cvv` string: Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
    - `brand` string: (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
    - `label` string: Indica a label do cartão
    - `billing_address_id` string: Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
    - `billing_address` object
      - `line_1` string: Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
      - `line_2` string: Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
      - `zip_code` string: CEP. Max: 16 caracteres.
      - `city` string: Cidade. Max: 64 caracteres.
      - `state` string: Código do estado no formato ISO 3166-2.
      - `country` string: Código do país no formato ISO 3166-1 alpha-2.
  - `boleto_due_days` integer: Dias para expiração do boleto. (Caso não seja passado, será pego um valor padrão das configurações da loja)
  - `code` string: Código da assinatura no sistema da loja. Máx.: 52 caracteres
  - `currency` string: Moeda. Valores possíveis: **BRL**
  - `start_at` string: Data de início da assinatura.<br>Se não for informada, a assinatura será iniciada **imediatamente**.
  - `interval` string: Intervalo da recorrência.<br>Valores possíveis: **day**, **week**, **month** ou **year**.
  - `interval_count` integer: Número de intervalos de acordo com a propriedade **interval** entre cada cobrança da assinatura. <br>Ex.: plano mensal = **interval_count** (1) e **interval** (month) <br> plano trimestral = **interval_count** (3) e **interval** (month) <br> plano semestral = **interval_count** (6) e** interval** (month)
  - `minimum_price` integer: Valor mínimo em centavos da assinatura.
  - `billing_type` string: Tipo de cobrança.<br>Valores possíveis: **prepaid**, **postpaid **ou **exact_day**.
  - `billing_day` integer: Dia da cobrança.<br>**Obrigatório**, caso o **billing_type** seja **exact_day**
  - `installments` integer: Quantidade de parcelas.<br>Será aplicada caso o método de pagamento da assinatura seja cartão de crédito.
  - `statement_descriptor` string: Texto exibido na fatura do cartão.<br>Será aplicado caso o método de pagamento da assinatura seja cartão de crédito. Máx.: 13 caracteres
  - `customer_id` string, required: Código do cliente.<br>**Obrigatório** caso o `customer` não seja informado. [Saiba mais sobre clientes](https://docs.pagar.me/v5/reference#clientes)
  - `customer` object, required: Dados do cliente.<br>**Obrigatório** caso o `customer_id` não seja informado. [Saiba mais sobre clientes](https://docs.pagar.me/v5/reference#clientes)
    - `name` string, required: Nome do cliente. Max: 64 caracteres.
    - `type` string: Tipo de cliente. Valores possíveis: individual (pessoa física) ou company (pessoa jurídica). Obrigatório, caso o document seja enviado.
    - `email` string: E-mail do cliente. Max: 64 caracteres.
    - `code` string: Código de referência do cliente no sistema da loja. Max: 52 caracteres.
    - `document` string: CPF, CNPJ ou PASSAPORTE do cliente. Max: 16 caracteres para CPF e CNPJ e Max: 50 caracteres para PASSAPORTE.
    - `document_type` string: Tipo de documento. Valores possíveis: "CPF", "CNPJ" ou "PASSPORT".
    - `gender` string: Sexo do cliente . Valores possíveis: male ou female.
    - `address` object: Endereço do cliente.
      - `country` string: País (Código do país no formato ISO 3166-1 alpha-2)(2 digitos)
      - `state` string: Estado (Código do estado no formato ISO 3166-2).
      - `city` string: Cidade.
      - `zip_code` string: Código Postal (CEP) (Apenas numérico).
      - `line_1` string: Dados principais do endereço. Neste campo deve ser informado Número, Rua, Bairro, nesta ordem e separados por vírgula.
      - `line_2` string: Dados complementares do endereço. Neste campo pode ser informado complemento, referências.
    - `phones` object: Telefone residencial do cliente.
      - `home_phone` object: Telefone residencial do cliente.
        - `country_code` string: Código do País (Apenas numérico).
        - `area_code` string: Código da área (Apenas numérico).
        - `number` string: Número do telefone (Apenas numérico).
      - `mobile_phone` object: Telefone celular do cliente.
        - `country_code` string: Código do País (Apenas numérico).
        - `area_code` string: Código da área (Apenas numérico).
        - `number` string: Número do telefone (Apenas numérico).
    - `birthdate` string, date: Data de nascimento do cliente.
    - `metadata` string: Objeto chave/valor utilizado para armazenar informações adicionais sobre o cliente.
  - `items` object[], required: Itens do assinatura.<br>[Saiba mais sobre item da assinatura](https://docs.pagar.me/v5/reference#item-da-assinatura)
    - `name` string: Nome do item.
    - `quantity` string, required: Quantidade de itens.
    - `description` string, required: Descrição do item. Máx.: 256 caracteres
    - `id` string: Código do item. Formato: pi_XXXXXXXXXXXXXXXX.
    - `status` string: Status do item. Valores possíveis: active, inactive ou deleted.
    - `created_at` string: Data de criação do item.
    - `updated_at` string: Data de atualização do item.
    - `pricing_scheme` object: Esquema de precificação do item.<br> [Saiba mais sobre precificação de Itens](https://docs.pagar.me/docs/price-scheme)
      - `scheme_type` string, required: Esquema de precificação do item. Valores possíveis: **unit**, **package**, **volume** e **tier**. Valor default: unit
      - `price` integer: Valor do item. Este atributo está disponível para o scheme_type : **Unit**
      - `mininum_price` integer: Valor mínimo a ser cobrado.
      - `price_brackets` object[]: Intervalo de preços. Este atributo está disponível para os scheme_type : **package**, **volume** e **tier**.
        - `start_quantity` integer: Valor que define a quantidade inicial de unidades do intervalo.
        - `end_quantity` integer: Valor que define a quantidade final de unidades do intervalo.
        - `overage_price` integer: Valor para cálculo do preço por unidade que exceder o intervalo.
        - `price` integer: Valor para cálculo do preço dentro do intervalo. OBS: o preço a ser cobrado do cliente será calculado de acordo com a quantidade e o scheme_type
  - `setup` object[]: Pedido que pode ser criado assim que a assinatura for iniciada. Ex: Pode ser utilizado como uma taxa de adesão ao serviço.
    - `amount` integer, required: Valor do setup pedido em centavos
    - `description` string, required: Descrição do setup (pedidos).
    - `payment` object: Pagamento do pedido, pode ser usado qualquer da nossas opções de pagamento. <br>[Saiba mais sobre pagamentos](https://docs.pagar.me/reference#vis%C3%A3o-geral-sobre-pagamento)
      - `bank` string: Código do banco. 001 (Banco do Brasil); 033 (Santander); 237 (Bradesco); 341 (Itau); 745 (Citibank) e 104 (Caixa Econômica Federal).
      - `instructions` string: Instruções do boleto. Max: 256 caracteres.
      - `due_at` string: Data de vencimento. (Opcional)
      - `nosso_numero` string: Número que identifica unicamente um boleto para uma conta.
      - `type` string: Tipo de espécie do boleto.DM (Duplicata Mercantil) e BDP (Boleto de proposta)
      - `document_number` string: Identificador do boleto. Max: 16 caracteres.
      - `interest` object: Aplicação do juros sobre o boleto.
        - `days` integer, required: Dias após a expiração do boleto quando o juros deve ser cobrado.
        - `type` string, required: Tipo de divisão. Os valores possíveis são flat ou percentage.
        - `amount` string, required: Valor em porcentagem ou em centavos da taxa de juros que será cobrada ao mês.
      - `fine` object: Aplicação da multa sobre o boleto.
        - `days` integer, required: Dias após a expiração do boleto quando a multa deve ser cobrada.
        - `type` string, required: Tipo de divisão. Os valores possíveis são flat ou percentage.
        - `amount` integer, required: Valor em porcentagem ou em centavos que será cobrada na multa.
      - `discount` object: Objeto raiz de desconto por antecipação. Exclusivo PSP.
        - `type` string: Tipo do desconto: "percentage" (% sobre o total) ou "flat" (centavos). Aplica-se a todas as regras do array.
        - `rules` object[]: Lista de regras de desconto ordenadas por limit_date crescente.
          - `limit_date` string: Data limite da regra. Formato YYYY-MM-DD. Deve ser anterior ao due_at do boleto.
          - `amount` integer: Valor do desconto. Se type: percentage: entre 0.01 e 100 (ex: 15.00 = 15%). Se type: flat: inteiro em centavos, mín. 1 (ex: 500 = R$5,00).
  - `discounts` object[]: Descontos.
    - `cycles` string: Número de vezes que o desconto será aplicado.
    - `value` string: Valor do desconto.
    - `discount_type` string: Tipo do desconto. Valores possíveis: flat ou percentage. Valor padrão: percentage.
  - `increments` object[]: Incrementos
    - `value` integer: Valor do incremento.
    - `cycles` string: Número de vezes que o incremento será aplicado.
    - `increment_type` string: Tipo do incremento. Valores possíveis: flat ou percentage. Valor padrão: percentage.
  - `gateway_affiliation_id` string: Código da afiliação no gateway.
  - `metadata` object: Objeto chave/valor utilizado para armazenar informações adicionais sobre a assinatura.<br>[Saiba mais sobre metadata](https://docs.pagar.me/v5/reference#metadata).

## Response `200`

200

- object
  - `id` string
  - `code` string
  - `start_at` string
  - `interval` string
  - `interval_count` integer
  - `billing_type` string
  - `current_cycle` object
    - `id` string
    - `start_at` string
    - `end_at` string
    - `billing_at` string
  - `next_billing_at` string
  - `payment_method` string
  - `currency` string
  - `installments` integer
  - `status` string
  - `created_at` string
  - `updated_at` string
  - `customer` object
    - `id` string
    - `name` string
    - `email` string
    - `delinquent` boolean
    - `created_at` string
    - `updated_at` string
    - `phones` object
  - `items` object[]
    - `id` string
    - `name` string
    - `description` string
    - `quantity` integer
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `pricing_scheme` object
      - `price` integer
      - `scheme_type` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ef323290c0ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagar/apis/pagarme-api/changes/subscriptions2/post.md)

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)