---
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`

## Request

- Base URL: `https://services.safe2pay.com.br`
- URL: `https://services.safe2pay.com.br/recurrence/v1/plans/{id}/subscriptions`
- Auth: API key in header `X-API-KEY`

## 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.dev/safe2pay/apis/services.md) - [All operations](https://skmtc.dev/safe2pay/apis/services/llms.txt) - [OpenAPI document](https://skmtc.dev/safe2pay/apis/services/revisions/133a27b98247?raw)