---
title: "Teste - Criar assinatura avulsa"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/teste-criar-assinatura-avulsa"
---
> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md
# Teste - Criar assinatura avulsa
`POST` `/subscriptions2`
Operation ID: `teste-criar-assinatura-avulsa`
Fornecemos a possibilidade de criação de uma assinatura (`subscription`) sem a necessidade de criação de um plano (`plan`).
## Request body
Content types: `application/json`
## Responses
- `200` - 200
- `400` - 400
## OpenAPI definition
```yaml
openapi: 3.1.0
info:
title: Pagar.me v5 API (Legado)
version: 5.0.0
servers:
- url: https://api.stone.com.br/core/v5
paths:
/subscriptions2:
post:
summary: Teste - Criar assinatura avulsa
description: Fornecemos a possibilidade de criação de uma assinatura
(`subscription`) sem a necessidade de criação de um plano (`plan`).
operationId: teste-criar-assinatura-avulsa
requestBody:
content:
application/json:
schema:
type: object
required:
- payment_method
- customer_id
- customer
- items
properties:
payment_method:
type: string
description: "Meio de pagamento.
Valores possíveis: **credit_card**,
**boleto** e **debit_card** ."
default: credit_card
card:
type: array
description: Cartão
**- card_id** é o código do cartão do cliente.
**-
card_token** é token do cartão gerado pelo checkout
transparente.
É **obrigatório** o envio de uma dessas
identificações, caso o **payment_method** seja credit_card
ou debit_card.
[Saiba mais sobre
cartões](https://docs.pagar.me/v5/reference#cart%C3%B5es).
items:
properties:
number:
type: string
description: Número do cartão. Entre 13 e 19 caracteres
holder_name:
type: string
description: 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:
type: string
description: CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do
cartão seja voucher (bandeiras VR ou Pluxee).
exp_month:
type: integer
description: Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
format: int32
exp_year:
type: integer
description: "Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023."
format: int32
cvv:
type: string
description: Código de segurança do cartão. O campo aceita 4 ou 3 caracteres,
variando por bandeira.
brand:
type: string
description: "(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:
type: string
description: Indica a label do cartão
billing_address_id:
type: string
description: "Código do endereço de cobrança. Max: 36 caracteres.<>Opcional,
pode ser utilizado no lugar do billing_address."
billing_address:
type: object
properties:
line_1:
type: string
description: "Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e
separados por vírgula) Max: 256 caracteres."
line_2:
type: string
description: "Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128
caracteres."
zip_code:
type: string
description: "CEP. Max: 16 caracteres."
city:
type: string
description: "Cidade. Max: 64 caracteres."
state:
type: string
description: Código do estado no formato ISO 3166-2.
country:
type: string
description: Código do país no formato ISO 3166-1 alpha-2.
required:
- number
- holder_name
- exp_month
- exp_year
type: object
boleto_due_days:
type: integer
description: Dias para expiração do boleto. (Caso não seja passado, será pego um
valor padrão das configurações da loja)
format: int32
code:
type: string
description: "Código da assinatura no sistema da loja. Máx.: 52 caracteres"
currency:
type: string
description: "Moeda. Valores possíveis: **BRL**"
default: BRL
start_at:
type: string
description: Data de início da assinatura.
Se não for informada, a assinatura
será iniciada **imediatamente**.
interval:
type: string
description: "Intervalo da recorrência.
Valores possíveis: **day**, **week**,
**month** ou **year**."
default: month
interval_count:
type: integer
description: "Número de intervalos de acordo com a propriedade **interval**
entre cada cobrança da assinatura.
Ex.: plano mensal =
**interval_count** (1) e **interval** (month)
plano
trimestral = **interval_count** (3) e **interval** (month)
plano semestral = **interval_count** (6) e** interval**
(month)"
default: 1
format: int32
minimum_price:
type: integer
description: Valor mínimo em centavos da assinatura.
default: null
format: int32
billing_type:
type: string
description: "Tipo de cobrança.
Valores possíveis: **prepaid**, **postpaid
**ou **exact_day**."
default: prepaid
billing_day:
type: integer
description: Dia da cobrança.
**Obrigatório**, caso o **billing_type** seja
**exact_day**
format: int32
installments:
type: integer
description: Quantidade de parcelas.
Será aplicada caso o método de pagamento
da assinatura seja cartão de crédito.
default: 1
format: int32
statement_descriptor:
type: string
description: "Texto exibido na fatura do cartão.
Será aplicado caso o método
de pagamento da assinatura seja cartão de crédito. Máx.: 13
caracteres"
customer_id:
type: string
description: Código do cliente.
**Obrigatório** caso o `customer` não seja
informado. [Saiba mais sobre
clientes](https://docs.pagar.me/v5/reference#clientes)
customer:
type: object
description: Dados do cliente.
**Obrigatório** caso o `customer_id` não seja
informado. [Saiba mais sobre
clientes](https://docs.pagar.me/v5/reference#clientes)
required:
- name
properties:
name:
type: string
description: "Nome do cliente. Max: 64 caracteres."
type:
type: string
description: "Tipo de cliente. Valores possíveis: individual (pessoa física) ou
company (pessoa jurídica). Obrigatório, caso o document
seja enviado."
email:
type: string
description: "E-mail do cliente. Max: 64 caracteres."
code:
type: string
description: "Código de referência do cliente no sistema da loja. Max: 52
caracteres."
document:
type: string
description: "CPF, CNPJ ou PASSAPORTE do cliente. Max: 16 caracteres para CPF e
CNPJ e Max: 50 caracteres para PASSAPORTE."
document_type:
type: string
description: 'Tipo de documento. Valores possíveis: "CPF", "CNPJ" ou
"PASSPORT".'
gender:
type: string
description: "Sexo do cliente . Valores possíveis: male ou female."
address:
type: object
description: Endereço do cliente.
properties:
country:
type: string
description: País (Código do país no formato ISO 3166-1 alpha-2)(2 digitos)
state:
type: string
description: Estado (Código do estado no formato ISO 3166-2).
city:
type: string
description: Cidade.
zip_code:
type: string
description: Código Postal (CEP) (Apenas numérico).
line_1:
type: string
description: Dados principais do endereço. Neste campo deve ser informado
Número, Rua, Bairro, nesta ordem e separados por
vírgula.
line_2:
type: string
description: Dados complementares do endereço. Neste campo pode ser informado
complemento, referências.
phones:
type: object
description: Telefone residencial do cliente.
properties:
home_phone:
type: object
description: Telefone residencial do cliente.
properties:
country_code:
type: string
description: Código do País (Apenas numérico).
area_code:
type: string
description: Código da área (Apenas numérico).
number:
type: string
description: Número do telefone (Apenas numérico).
mobile_phone:
type: object
description: Telefone celular do cliente.
properties:
country_code:
type: string
description: Código do País (Apenas numérico).
area_code:
type: string
description: Código da área (Apenas numérico).
number:
type: string
description: Número do telefone (Apenas numérico).
birthdate:
type: string
description: Data de nascimento do cliente.
format: date
metadata:
type: string
description: Objeto chave/valor utilizado para armazenar informações adicionais
sobre o cliente.
items:
type: array
description: Itens do assinatura.
[Saiba mais sobre item da
assinatura](https://docs.pagar.me/v5/reference#item-da-assinatura)
items:
properties:
name:
type: string
description: Nome do item.
quantity:
type: string
description: Quantidade de itens.
description:
type: string
description: "Descrição do item. Máx.: 256 caracteres"
id:
type: string
description: "Código do item. Formato: pi_XXXXXXXXXXXXXXXX."
status:
type: string
description: "Status do item. Valores possíveis: active, inactive ou deleted."
created_at:
type: string
description: Data de criação do item.
updated_at:
type: string
description: Data de atualização do item.
pricing_scheme:
type: object
description: Esquema de precificação do item.
[Saiba mais sobre precificação
de Itens](https://docs.pagar.me/docs/price-scheme)
required:
- scheme_type
properties:
scheme_type:
type: string
description: "Esquema de precificação do item. Valores possíveis: **unit**,
**package**, **volume** e **tier**. Valor default:
unit"
default: Unit
price:
type: integer
description: "Valor do item. Este atributo está disponível para o scheme_type :
**Unit**"
format: int32
mininum_price:
type: integer
description: Valor mínimo a ser cobrado.
format: int32
price_brackets:
type: array
description: "Intervalo de preços. Este atributo está disponível para os
scheme_type : **package**, **volume** e **tier**."
items:
properties:
start_quantity:
type: integer
description: Valor que define a quantidade inicial de unidades do intervalo.
format: int32
end_quantity:
type: integer
description: Valor que define a quantidade final de unidades do intervalo.
format: int32
overage_price:
type: integer
description: Valor para cálculo do preço por unidade que exceder o intervalo.
format: int32
price:
type: integer
description: "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"
format: int32
type: object
required:
- quantity
- description
type: object
setup:
type: array
description: "Pedido que pode ser criado assim que a assinatura for iniciada.
Ex: Pode ser utilizado como uma taxa de adesão ao serviço."
items:
properties:
amount:
type: integer
description: Valor do setup pedido em centavos
format: int32
description:
type: string
description: Descrição do setup (pedidos).
payment:
type: object
description: Pagamento do pedido, pode ser usado qualquer da nossas opções de
pagamento.
[Saiba mais sobre
pagamentos](https://docs.pagar.me/reference#vis%C3%A3o-geral-sobre-pagamento)
properties:
bank:
type: string
description: Código do banco. 001 (Banco do Brasil); 033 (Santander); 237
(Bradesco); 341 (Itau); 745 (Citibank) e 104
(Caixa Econômica Federal).
instructions:
type: string
description: "Instruções do boleto. Max: 256 caracteres."
due_at:
type: string
description: Data de vencimento. (Opcional)
nosso_numero:
type: string
description: Número que identifica unicamente um boleto para uma conta.
type:
type: string
description: Tipo de espécie do boleto.DM (Duplicata Mercantil) e BDP (Boleto de
proposta)
document_number:
type: string
description: "Identificador do boleto. Max: 16 caracteres."
interest:
type: object
description: Aplicação do juros sobre o boleto.
required:
- days
- type
- amount
properties:
days:
type: integer
description: Dias após a expiração do boleto quando o juros deve ser cobrado.
format: int32
type:
type: string
description: Tipo de divisão. Os valores possíveis são flat ou percentage.
amount:
type: string
description: Valor em porcentagem ou em centavos da taxa de juros que será
cobrada ao mês.
fine:
type: object
description: Aplicação da multa sobre o boleto.
required:
- days
- type
- amount
properties:
days:
type: integer
description: Dias após a expiração do boleto quando a multa deve ser cobrada.
format: int32
type:
type: string
description: Tipo de divisão. Os valores possíveis são flat ou percentage.
amount:
type: integer
description: Valor em porcentagem ou em centavos que será cobrada na multa.
format: int32
discount:
type: object
description: Objeto raiz de desconto por antecipação. Exclusivo PSP.
properties:
type:
type: string
description: 'Tipo do desconto: "percentage" (% sobre o total) ou "flat"
(centavos). Aplica-se a todas as regras do
array.'
rules:
type: array
description: Lista de regras de desconto ordenadas por limit_date crescente.
items:
properties:
limit_date:
type: string
description: Data limite da regra. Formato YYYY-MM-DD. Deve ser anterior ao
due_at do boleto.
amount:
type: integer
description: "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)."
format: int32
type: object
required:
- amount
- description
type: object
discounts:
type: array
description: Descontos.
items:
properties:
cycles:
type: string
description: Número de vezes que o desconto será aplicado.
value:
type: string
description: Valor do desconto.
discount_type:
type: string
description: "Tipo do desconto. Valores possíveis: flat ou percentage. Valor
padrão: percentage."
type: object
increments:
type: array
description: Incrementos
items:
properties:
value:
type: integer
description: Valor do incremento.
format: int32
cycles:
type: string
description: Número de vezes que o incremento será aplicado.
increment_type:
type: string
description: "Tipo do incremento. Valores possíveis: flat ou percentage. Valor
padrão: percentage."
type: object
gateway_affiliation_id:
type: string
description: Código da afiliação no gateway.
metadata:
type: object
description: Objeto chave/valor utilizado para armazenar informações adicionais
sobre a assinatura.
[Saiba mais sobre
metadata](https://docs.pagar.me/v5/reference#metadata).
properties: {}
examples:
JSON (with credit card):
value:
code: "123456"
payment_method: credit_card
currency: BRL
start_at: 2025-04-03
interval: month
interval_count: "1"
minimum_price: "10000"
billing_type: exact_day
billing_day: 10
installments: 5
statement_descriptor: Assinatura x
customer:
name: Tony Stark
email: tonystark@avengers.com
type: individual
document: "28619068040"
card:
holder_name: Tony Stark
number: "4000000000000010"
exp_month: 1
exp_year: 30
cvv: "903"
billing_address:
line_1: 375, Av. General Justo, Centro
line_2: 8º andar
zip_code: "20021130"
city: Rio de Janeiro
state: RJ
country: BR
items:
- description: Musculação
quantity: 1
pricing_scheme:
price: 18990
setup:
amount: "2000"
description: Taxa de adesão
payment:
payment_method: credit_card
credit_card:
card:
holder_name: Tony Stark
number: "4000000000000010"
exp_month: 1
exp_year: 30
cvv: "903"
billing_address:
line_1: 375, Av. General Justo, Centro
line_2: 8º andar
zip_code: "20021130"
city: Rio de Janeiro
state: RJ
country: BR
metadata:
id: my_subscription_id
JSON (with boleto):
value:
code: "123456"
payment_method: boleto
start_at: 2025-04-03
interval: month
interval_count: "1"
minimum_price: "10000"
billing_type: exact_day
billing_day: 10
boleto_due_days: 5
customer:
name: Tony Stark
email: tonystark@avengers.com
type: individual
document: "28619068040"
address:
line_1: 375, Av. General Justo, Centro
line_2: 8º andar
zip_code: "20021130"
city: Rio de Janeiro
state: RJ
country: BR
items:
- description: Musculação
quantity: 1
pricing_scheme:
price: 18990
setup:
amount: "2000"
description: Taxa de adesão
payment:
payment_method: boleto
boleto:
instructions: Pagar até o vencimento
due_at: 2025-09-20T00:00:00Z
document_number: "47683264474"
type: DM
metadata:
id: my_subscription_id
responses:
"200":
description: "200"
content:
application/json:
examples:
OK (with credit card):
value: >-
{
"id": "sub_05jkdIfGYPfN26mI",
"payment_method": "credit_card",
"currency": "BRL",
"interval": "month",
"interval_count": 3,
"gateway_affiliation_id": "C56A4180-65AA-42EC-A945-5FD21DEC0538",
"minimum_price": 10000,
"billing_type": "prepaid",
"boleto_due_days":5,
"current_period": {
"start_at": "2016-07-19T00:00:00Z",
"end_at": "2016-10-18T23:59:59Z"
},
"next_billing_at": "2016-10-19T00:00:00Z",
"installments": 3,
"customer": {
"id": "cus_017228NmffGbA3d4",
"name": "Tony Stark",
"email": "tonystark@avengers.com",
"delinquent": false,
"created_at": "2016-07-12T18:25:40Z",
"updated_at": "2016-07-12T18:25:40Z"
},
"credit_card": {
"id": "card_Mome2meGz4PDNQbX",
"holder_name": "Tony Stark",
"masked_number": "453246******5322",
"exp_month": 1,
"exp_year": 30,
"expired": false,
"status": "active",
"created_at": "2016-07-12T18:25:40Z",
"update_at": "2016-07-12T18:25:40Z",
"billing_address": {
"id": "addr_Mome2meGz4PDNQbX",
"line_1": "375, Av. General Justo, Centro",
"line_2": "8º andar",
"zip_code": "20021130",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR",
"status": "active",
"created_at": "2016-07-12T18:25:40Z",
"updated_at": "2016-07-12T18:25:40Z"
}
},
"discounts": [
{
"id": "si_k2zpBDMsOs0fDfHe",
"cycles": 3,
"value": 10,
"discount_type": "percentage",
"created_at": "2016-07-12T18:25:40Z"
}
],
"increments": [
{
"id": "inc_IYzpxgjsOs0fDIoP",
"cycles": 2,
"value": 20,
"discount_type": "percentage",
"created_at": "2016-07-12T18:25:40Z"
}
],
"items": [
{
"id": "si_B6555Riyq9lj6klS",
"description": "Musculação",
"quantity": 1,
"pricing_scheme": {
"price": 18990,
"scheme_type": "unit"
},
"status": "active",
"created_at": "2016-07-12T18:25:40Z",
"updated_at": "2016-07-12T18:25:40Z"
},
{
"id": "si_lFjtC2xYGttulJpn",
"description": "Matrícula",
"quantity": 1,
"cycles": 1,
"pricing_scheme": {
"price": 5990,
"scheme_type": "unit"
},
"status": "active",
"created_at": "2016-07-12T18:25:40Z",
"updated_at": "2016-07-12T18:25:40Z"
}
],
"status": "active",
"created_at": "2016-07-12T18:25:40Z",
"updated_at": "2016-07-12T18:25:40Z",
"metadata": {
"id": "my_subscription_id"
}
}
OK (with boleto):
value: >-
{
"id": "sub_8RQW76TG8SOeYZro",
"code": "3R0ZSQ5BJ5",
"start_at": "2018-04-04T00:00:00Z",
"interval": "month",
"interval_count": 1,
"billing_type": "prepaid",
"current_cycle": {
"id": "cycle_GvX8zgQU9NUemBm5",
"start_at": "2018-04-04T00:00:00Z",
"end_at": "2018-05-03T23:59:59Z",
"billing_at": "2018-04-04T00:00:00Z"
},
"next_billing_at": "2018-05-04T00:00:00Z",
"payment_method": "boleto",
"currency": "BRL",
"installments": 1,
"status": "active",
"created_at": "2018-04-04T20:59:01Z",
"updated_at": "2018-04-04T20:59:01Z",
"customer": {
"id": "cus_a21Y9wCnVszRqVR5",
"name": "Tony Stark",
"email": "903c2a55-0ce0-47c5-8b64-fa6a3036f861@avengers.com",
"delinquent": false,
"created_at": "2018-04-04T20:59:01Z",
"updated_at": "2018-04-04T20:59:01Z",
"phones": {}
},
"items": [
{
"id": "si_6DOoWzDip7izX8xV",
"name": "Premium",
"description": "Sem anuncios",
"quantity": 1,
"status": "active",
"created_at": "2018-04-04T20:59:01Z",
"updated_at": "2018-04-04T20:59:01Z",
"pricing_scheme": {
"price": 1490,
"scheme_type": "unit"
}
},
{
"id": "si_yp9G6e2T54t0r7OB",
"name": "Silver",
"description": "Com anuncios",
"quantity": 1,
"status": "active",
"created_at": "2018-04-04T20:59:01Z",
"updated_at": "2018-04-04T20:59:01Z",
"pricing_scheme": {
"price": 2000,
"scheme_type": "unit"
}
}
]
}
schema:
type: object
properties:
id:
type: string
example: sub_8RQW76TG8SOeYZro
code:
type: string
example: 3R0ZSQ5BJ5
start_at:
type: string
example: 2018-04-04T00:00:00Z
interval:
type: string
example: month
interval_count:
type: integer
example: 1
default: 0
billing_type:
type: string
example: prepaid
current_cycle:
type: object
properties:
id:
type: string
example: cycle_GvX8zgQU9NUemBm5
start_at:
type: string
example: 2018-04-04T00:00:00Z
end_at:
type: string
example: 2018-05-03T23:59:59Z
billing_at:
type: string
example: 2018-04-04T00:00:00Z
next_billing_at:
type: string
example: 2018-05-04T00:00:00Z
payment_method:
type: string
example: boleto
currency:
type: string
example: BRL
installments:
type: integer
example: 1
default: 0
status:
type: string
example: active
created_at:
type: string
example: 2018-04-04T20:59:01Z
updated_at:
type: string
example: 2018-04-04T20:59:01Z
customer:
type: object
properties:
id:
type: string
example: cus_a21Y9wCnVszRqVR5
name:
type: string
example: Tony Stark
email:
type: string
example: 903c2a55-0ce0-47c5-8b64-fa6a3036f861@avengers.com
delinquent:
type: boolean
example: false
default: true
created_at:
type: string
example: 2018-04-04T20:59:01Z
updated_at:
type: string
example: 2018-04-04T20:59:01Z
phones:
type: object
properties: {}
items:
type: array
items:
type: object
properties:
id:
type: string
example: si_6DOoWzDip7izX8xV
name:
type: string
example: Premium
description:
type: string
example: Sem anuncios
quantity:
type: integer
example: 1
default: 0
status:
type: string
example: active
created_at:
type: string
example: 2018-04-04T20:59:01Z
updated_at:
type: string
example: 2018-04-04T20:59:01Z
pricing_scheme:
type: object
properties:
price:
type: integer
example: 1490
default: 0
scheme_type:
type: string
example: unit
"400":
description: "400"
content:
application/json:
examples:
Result:
value: "{}"
schema:
type: object
properties: {}
deprecated: false
security:
- sec0: []
components:
securitySchemes:
sec0:
type: http
scheme: basic
```