---
updatedAt: 2026-08-26T16:58:29.000Z
agentTools:
projectIndex: https://developer.pagbank.com.br/llms.txt
---
# Objeto Assinante
[block:html]
{
"html": "\n\n\n\n \n
id String (41 caracteres)\n
Id do cliente no formato CUST_UUID.\n
Exemplo: CUST_00001\n
\n
\n
reference_id String (65 caracteres)\n
Código externo informado pelo merchant.\n
Exemplo: ex-00001\n
\n
\n
email String (60 caracteres)\n
Email do cliente.\n
Exemplo: joão.maria@email.com\n
\n
\n
name String (150 caracteres)\n
Nome completo do cliente.\n
Exemplo: João Maria\n
\n
\n
tax_id String (11/14 caracteres)\n
CPF ou CNPJ do cliente. Somente dígitos numéricos.\n
Exemplo: 01234567890 ou 01234567890123\n
\n
\n
birth_date Date\n
Data de nascimento do cliente. Formato AAAA-MM-DD.\n
Exemplo: 1990-12-30\n
\n
\n phones Array of objects\n
\n Lista de objetos contendo detalhes de telefones do cliente.\n
\n \n
\n
area String (2 caracteres)\n
Código de área do telefone.\n
Exemplo: 41\n
\n
\n\n
\n
country String (2 caracteres)\n
Código do país do telefone.\n 
\n Apenas telefones com DDI 55 são aceitos. ![](\"https://emojiguide.org/images/emoji/y/1rfc1hb1fsduy.png\")
\n
Exemplo: 55\n
\n
\n\n
\n
number String (8/9 caracteres)\n
Número de telefone. Somente dígitos numéricos.\n
Exemplo: 999165369\n
\n
\n\n
\n
id Integer\n
Id numérico identificador.\n
\n
\n\n
\n\n \n address Object\n
\n Objeto de detalhes do endereço do cliente.\n
\n \n
\n
street String (150 caracteres)\n
Nome da rua.\n
Exemplo: Getúlio Vargas\n
\n
\n\n
\n
number String (8 caracteres)\n
Número da casa.\n
Exemplo: 750\n
\n
\n\n
\n
complement String (40 caracteres)\n
Complemento do endereço.\n
Exemplo: ap121\n
\n
\n\n
\n
locality String (60 caracteres)\n
Bairro.\n
Exemplo: Laranjeiras\n
\n
\n\n
\n
city String (60 caracteres)\n
Cidade.\n
Exemplo: Rio de Janeiro\n
\n
\n\n
\n
region_code String (2 caracteres)\n
Estado (sigla).\n
Exemplo: RJ\n
\n
\n\n
\n
country String (3 caracteres)\n
País em formato ISO-alpha3.\n
Exemplo: BRA\n
\n
\n\n
\n
postal_code String (8 caracteres)\n
CEP do endereço.\n
Exemplo: 45624116\n
\n
\n
\n\n \n billing_info Array of objects\n
\n Lista de objetos de informações de pagamento.\n
\n \n
\n
type String\n
Tipo do meio de cobrança.\n
Exemplo: CREDIT_CARD\n
\n
\n\n
\n card Object\n
\n Objeto de detalhes do cartão.\n
\n \n\n
\n
number String (14-19 caracteres)\n
Número do cartão.\n \n Necessário Certificação PCI \n
Exemplo: 1234567890123456\n
\n
\n\n
\n
exp_year String (1/2 caracteres)\n
Ano de expiração do cartão.\n \n Necessário Certificação PCI \n
Exemplo: 25\n
\n
\n\n
\n
exp_month String (2/4 caracteres)\n
Mês de expiração do cartão.\n \n Necessário Certificação PCI \n
Exemplo: 12\n
\n
\n\n
\n holder Object\n
\n Objeto do portador do cartão.\n \n Necessário Certificação PCI \n
\n \n
\n
name String (30 caracteres)\n
Nome do portador, impresso no cartão.\n \n Necessário Certificação PCI \n
Exemplo: John Doe\n
\n
\n
\n\n
\n
encrypted String\n
Cartão criptografado.\n \n Substitui todos os outros dados do cartão \n
\n
\n\n
\n
token String (41 caracteres)\n
Token do cartão no formato TOKE_UUID.\n
Exemplo: TOKE_0001\n
\n
\n\n
\n
brand String\n
Bandeira do Cartão.\n
Exemplo: Visa\n
\n
\n\n
\n
first_digits String (6 caracteres)\n
6 primeiros dígitos do cartão.\n
Exemplo: 123456\n
\n
\n\n
\n
last_digits String (4 caracteres)\n
4 últimos dígitos do cartão.\n
Exemplo: 7890\n
\n
\n\n
\n
\n\n \n
created_at Datetime\n
Data de criação do cliente.\n
Exemplo: 2023-01-01T12:00:00Z\n
\n
\n
updated_at Datetime\n
Data de última atualização do cliente.\n
Exemplo: 2023-02-15T12:00:00Z\n
\n
\n links Array of objects\n
\n Lista de links referentes ao cliente.\n
\n \n
\n
rel String\n
Relação entre o link e o cliente.\n
Exemplo: SELF\n
\n
\n\n
\n
href String\n
URL associada ao link.\n
Exemplo: http://sandbox.api.assinaturas.pagseguro.com/customers/CUST_2E9290E4-8149-4AEE-8A6B-F04055EFCEA1\n
\n
\n\n
\n
media String\n
Tipo de mídia associada ao link.\n
Exemplo: application/json\n
\n
\n\n
\n
type String\n
Tipo de link.\n
Exemplo: GET\n
\n
\n
\n\n"
}
[/block]
> 🚧 Tipos de cartões
>
> É aceito cartões pessoa física e jurídica.
>
> Bandeiras de cartão de crédito:
>
> * VISA
> * MASTERCARD
> * AMEX
> * ELO
> * HIPERCARD
> * HIPER
> * DINERS
>
> Bandeiras de cartão de débito:
>
> * VISA
> * MASTERCARD
> * ELO\
> Bandeiras de token de rede:
> * VISA
> * MASTERCARD
> * ELO