---
title: "POST /recurrence/v1/plans/{id}/subscriptions"
method: POST
path: "/recurrence/v1/plans/{id}/subscriptions"
---

# POST /recurrence/v1/plans/{id}/subscriptions

`POST /recurrence/v1/plans/{id}/subscriptions`

## Path parameters

- `id` string, required

## Request body

- object
  - `PaymentMethod` string, required — Código do método de pagamento. Ex: "1" (Boleto Bancário), "2" (Cartão de Crédito)
  - `Customer` object, required — Grupo de dados com informação do cliente.
    - `Name` string, required — Nome do cliente.
    - `Identity` string, required — Documento de identificação (CPF / CNPJ) do cliente.
    - `Phone` string, required — Telefone do cliente.
    - `Email` string, required — Email do cliente. para os casos de assinatura com pagamento via cartão de crédito, sem cartão tokenizado, esse caixa de e-mail irá receber um e-mail contendo o link para tokenização do cartão.
    - `Address` object, required — Grupo de dados com a informação do endereço do cliente.
      - `Street` string, required — Rua do cliente.
      - `Number` string, required — Número da rua do cliente.
      - `District` string, required — Bairro do cliente
      - `ZipCode` string, required — CEP do cliente.
      - `Complement` string — Complemento do endereço do cliente.
      - `City` object, required — Grupo de dados com a informação da Cidade.
        - `CodeIBGE` string, required — Código IBGE da cidade do cliente.
  - `Emails` string[], required — Esses e-mails receberão o link para tokenização do cartão no momento da assinatura ou o boleto de cobrança. Se a assinatura for via cartão de crédito e o cartão já está tokenizado, não realizamos envio de e-mail.
  - `Token` string — Token de identificação do cartão de crédito. Ex: 23e2dfdc6ea14c3aaeca924d1397e2c20 (Caso o cartão ainda não esteja tokenizado. Use [esse endpoint](https://docs.safe2pay.dev/reference/cobranca-cartao-credito-cofre-criar-token#/) para tokenizar antes de realizar a assinatura)
  - `Vendor` string — Nome do vendedor que será vinculado a essa assinatura e as respectivas cobranças. Ex: João da Silva

## Response `200`

---

[API](https://skmtc.net/safe2pay/apis/payment.md) · [All operations](https://skmtc.net/safe2pay/apis/payment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safe2pay/payment/versions/8efee77775ac/schema)