---
title: "Alterar dados de pagamento do assinante"
method: PUT
path: "/customers/{customer_id}/billing_info"
---

# Alterar dados de pagamento do assinante

`PUT /customers/{customer_id}/billing_info`

## Path parameters

- `customer_id` string, required

## Headers

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

## Request body

- object
  - `RAW_BODY` 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)