---
title: "Criar assinante"
method: POST
path: "/customers"
---

# Criar assinante

`POST /customers`

## Headers

- `Authorization` string, required
- `x-idempotency-key` string

## Request body

- object
  - `reference_id` string — Identificador único atribuído para o assinante. Utilizado internamente pelo vendedor em seu sistema (Max 65 caracteres).
  - `name` string — Nome completo do assinante (Max 150 caracteres). ⚠️**Obrigatório**⚠️
  - `email` string — E-mail válido do assinante (Max 60 caracteres). O e-mail deve ser diferente do e-mail do merchant (vendedor). ⚠️**Obrigatório**⚠️
  - `tax_id` string — Número do documento do assinante, CPF com 11 dígitos e CNPJ com 14 dígitos numéricos. ⚠️**Forneça apenas números. Obrigatório.**⚠️
  - `phones` object[] — Objeto contendo o(s) telefone(s) do assinante. ⚠️**Deve conter no mínimo um telefone.**⚠️
    - `country` string — Código de area do país. ⚠️ **Obrigatório, somente código do Brasil(55) aceito no momento. **⚠️<br><small>Exemplo: 55 (Brasil)</small>
    - `area` string — Código do estado (DDD) do telefone (Max 3 caracteres). ⚠️ **Obrigatório**⚠️
    - `number` string — Telefone do assinante (Max 9 caracteres). ⚠️ **Obrigatório**⚠️
  - `birth_date` string, date — Data de nascimento do assinante. <br><small>Exemplo: 2000-12-20</small>
  - `address` object — Objeto de detalhes do endereço do assinante.
    - `street` string — Logradouro do endereço (Max 150 caracteres). Não são aceitos caracteres especiais. ⚠️ **Obrigatório** ⚠️
    - `number` string — Número do endereço (Max 8 caracteres). ⚠️ **Obrigatório** ⚠️
    - `complement` string — Complemento do endereço (Max 40 caracteres), ⚠️ **Não aceita espaços entre palavras.**⚠️
    - `locality` string — Bairro do assinante (Max 60 caracteres).⚠️ **Obrigatório** ⚠️
    - `city` string — Cidade do assinante (Max 60 caracteres). ⚠️ **Obrigatório** ⚠️
    - `region_code` string — Estado (sigla) do assinante (Max 2 caracteres). ⚠️ **Obrigatório** ⚠️ <br><small>Exemplo: MG </small>.
    - `postal_code` string — CEP do endereço (8 caracteres). ⚠️ **Apenas dígitos numéricos. Obrigatório.** ⚠️
    - `country` 'BRA' — País em formato ISO-alpha3. ⚠️**No momento, apenas o valor BRA é aceito.** ⚠️ <br><small>Exemplo BRA.</small>
  - `billing_info` object[] — Objeto com dados de pagamento do assinante.
    - `type` '' | 'CREDIT_CARD' — Deve ser informado o CREDIT_CARD. ⚠️**Obrigatório**⚠️
    - `card` object — Objeto com os dados do cartão. ⚠️**Obrigatório**⚠️
      - `encrypted` string — Dados do cartão criptografados. Para aprender como criptografar o cartão, acesse a página de [Criptografia](https://developer.pagbank.com.br/docs/criptografia-e-chave-publica). ⚠️**Obrigatório quando o integrador NÃO possuir certificação PCI. Caso este parâmetro seja preenchido, nenhum outro parâmetro deverá ser enviado.**⚠️
      - `number` string — Número do cartão do assinante (Min 14; Max 19 caracteres).
      - `security_code` integer — Código de segurança do cartão (CVV) (Min 3; Max 4 digitos). ⚠️**Obrigatório para realizar a validação do cartão antes de criar o assinante.**⚠️
      - `exp_year` string — Ano de expiração do cartão (2 ou 4 digitos). <br><small>Exemplo: 23 ou 2023.</small>
      - `exp_month` string — Mês de expiração do cartão (2 digitos). <br><small>Valores aceitos entre 01 e 12.</small>
      - `holder` object — Objeto com detalhes do dono do cartão.
        - `name` string — Nome do dono do cartão (Min 2; Max 30 caracteres). ⚠️Obrigatório⚠️
        - `birth_date` string — Data de nascimento do dono do cartão.
        - `tax_id` string — Esse campo aceita somente um CPF ou CNPJ válido. Entre 11 e 14 caracteres e apenas números.
        - `phone` object — Telefone do dono do cartao.
          - `country` string — Código de area do país. ⚠️ **Obrigatório, somente código do Brasil(55) aceito no momento. **⚠️<br><small>Exemplo: 55 (Brasil)</small>
          - `area` string — Código do estado (DDD) do telefone (Max 3 caracteres). ⚠️ **Obrigatório**⚠️
          - `number` string — Telefone do assinante (Max 9 caracteres). ⚠️ **Obrigatório**⚠️

## Response `200`

200

- object
  - `id` string
  - `reference_id` string
  - `email` string
  - `name` string
  - `tax_id` string
  - `phones` object[]
    - `id` integer
    - `area` string
    - `country` string
    - `number` string
  - `birth_date` string
  - `address` object
    - `street` string
    - `number` string
    - `complement` string
    - `locality` string
    - `city` string
    - `region_code` string
    - `country` string
    - `postal_code` string
  - `billing_info` object[]
    - `type` string
    - `card` object
      - `token` string
      - `brand` string
      - `first_digits` string
      - `last_digits` string
      - `exp_month` string
      - `exp_year` string
      - `holder` object
        - `name` string
  - `created_at` string
  - `updated_at` string
  - `links` object[]
    - `rel` string
    - `href` string
    - `media` string
    - `type` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/pagbank/apis/nova-plataforma-sandbox.md) · [All operations](https://skmtc.net/pagbank/apis/nova-plataforma-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagbank/nova-plataforma-sandbox/revisions/05e64f3006ab/schema)