Consultando dados de uma Conta Cartão
Existem duas maneiras para se consultar as informações de uma conta, independente do tipo de programa:
- Fetching data from an account - Retorna exatamente a conta referente ao accountId informado. Este accountId é obtido atraves do webhook de
account-created. - Buscar conta - Retorna uma lista de contas, pois um mesmo documento pode estar vinculado a mais de um programa. Caso o webhook
account-creatednão seja recebido, utilize este endpoint para localizar o portador.
Para pesquisar de outras formas utilize a documentação da API.
Meaning of objects
| Fields (required) | Type | Description |
|---|---|---|
| program | list | Lista dos programas aos quais a conta faz parte. |
| dueDate | list | Data de vencimento da fatura do cliente. |
| name | string (100) | Nome do titular do cartão |
| string (100) | E-mail do titular da conta | |
| gender | string (1) | Gênero do titular. M para masculino, F para feminino |
| maritalStatus | string (10) | Status civil do titular. SINGLE (solteiro), MARRIED (casado), DIVORCED (divorciado), WIDOWER (viúvo) |
| (grantedLimit) | int | Limite concedido para pós-pago (informado pelo cliente) - obrigatório apenas para programas de crédito, incluindo cartões pré-pago que transacionam na trilha do crédito |
| (limit) | int | Limite que o cliente definiu para uso, sempre igual ou menor que o granted_limit. -opcional |
| accountType | string (30) | Tipo de conta. Sempre preencher com PHYSICAL. |
| accountName | string (50) | Account owner name for identification |
| documentNumber | string (20) | Cardholder document (CPF or CNPJ) |
| birthDate | string (10) | Cardholder's date of birth |
| phoneType | string (10) | Tipo de telefone. RESIDENTIAL (residencial), COMMERTIAL (comercial), MOBILE (celular) |
| countryCode | int | DDI where the phone is |
| phone | string (10) | Phone number |
| areaCode | int | DDD where the phone is located |
| addressType | string (10) | Tipo de endereço. RESIDENTIAL (residencial), COMMERTIAL (comercial), Others |
| address | string (50) | Address street |
| number | int | Address number |
| neighborhood | string (50) | Address neighborhood |
| city | string (50) | Address city |
| state | string (2) | Address status |
| country | string (5) | Address country |
| zipCode | string (10) | Address zip code |
| mailingAddress | boolean | Indica se é o endereço de entrega e correspondência. |
| complementaryAddress | string (100) | Additional information for the address |