id String (41 caracteres)
Id do cliente no formato CUST_UUID
.
Exemplo: CUST_00001
reference_id String (65 caracteres)
Código externo informado pelo merchant.
Exemplo: ex-00001
email String (60 caracteres)
Email do cliente.
Exemplo: joã[email protected]
name String (150 caracteres)
Nome completo do cliente.
Exemplo: João Maria
tax_id String (11/14 caracteres)
CPF ou CNPJ do cliente. Somente dígitos numéricos.
Exemplo: 01234567890 ou 01234567890123
birth_date Date
Data de nascimento do cliente. Formato AAAA-MM-DD
.
Exemplo: 1990-12-30
phones Array of objects
Lista de objetos contendo detalhes de telefones do cliente.
area String (2 caracteres)
Código de área do telefone.
Exemplo: 41
country String (2 caracteres)
Código do país do telefone.
Apenas telefones com DDI 55 são aceitos.
Exemplo: 55
number String (8/9 caracteres)
Número de telefone. Somente dígitos numéricos.
Exemplo: 999165369
id Integer
Id numérico identificador.
address Object
Objeto de detalhes do endereço do cliente.
street String (150 caracteres)
Nome da rua.
Exemplo: Getúlio Vargas
number String (8 caracteres)
Número da casa.
Exemplo: 750
complement String (40 caracteres)
Complemento do endereço.
Exemplo: ap121
locality String (60 caracteres)
Bairro.
Exemplo: Laranjeiras
city String (60 caracteres)
Cidade.
Exemplo: Rio de Janeiro
region_code String (2 caracteres)
Estado (sigla).
Exemplo: RJ
country String (3 caracteres)
País em formato ISO-alpha3.
Exemplo: BRA
postal_code String (8 caracteres)
CEP do endereço.
Exemplo: 45624116
billing_info Array of objects
Lista de objetos de informações de pagamento.
type String
Tipo do meio de cobrança.
Exemplo: CREDIT_CARD
card Object
Objeto de detalhes do cartão.
number String (14-19 caracteres)
Número do cartão.
Necessário Certificação PCI
Exemplo: 1234567890123456
exp_year String (1/2 caracteres)
Ano de expiração do cartão.
Necessário Certificação PCI
Exemplo: 25
exp_month String (2/4 caracteres)
Mês de expiração do cartão.
Necessário Certificação PCI
Exemplo: 12
holder Object
Objeto do portador do cartão.
Necessário Certificação PCI
name String (30 caracteres)
Nome do portador, impresso no cartão.
Necessário Certificação PCI
Exemplo: John Doe
encrypted String
Cartão criptografado.
Substitui todos os outros dados do cartão
token String (41 caracteres)
Token do cartão no formato TOKE_UUID.
Exemplo: TOKE_0001
brand String
Bandeira do Cartão.
Exemplo: Visa
first_digits String (6 caracteres)
6 primeiros dígitos do cartão.
Exemplo: 123456
last_digits String (4 caracteres)
4 últimos dígitos do cartão.
Exemplo: 7890
created_at Datetime
Data de criação do cliente.
Exemplo: 2023-01-01T12:00:00Z
updated_at Datetime
Data de última atualização do cliente.
Exemplo: 2023-02-15T12:00:00Z
links Array of objects
Lista de links referentes ao cliente.
rel String
Relação entre o link e o cliente.
Exemplo: SELF
href String
URL associada ao link.
Exemplo: http://sandbox.api.assinaturas.pagseguro.com/customers/CUST_2E9290E4-8149-4AEE-8A6B-F04055EFCEA1
media String
Tipo de mídia associada ao link.
Exemplo: application/json
type String
Tipo de link.
Exemplo: GET
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