Atualizar uma conta
ATUALIZAR
Essa funcionalidade permite que os clientes da Celcoin atualizem os dados cadastrais relacionados a contas que ainda não foram submetidas para criação ou já criadas.
Para contas criadas, é possível realizar a alteração dos seguintes campos:
| Campo | Tipo | Descrição |
|---|---|---|
| due_date | int | Dia fechamento da fatura |
| name | string (100) | Nome do responsável que vai receber os cartões |
| string (100) | E-mail do responsável que vai receber os cartões | |
| gender | string (1) | Indica o gênero do portador da conta M para masculino e F para feminino |
| marital_status | string (10) | Indica o status civil do portador da conta, SINGLE para solteiro, MARRIED para casado, DIVORCED para divorcio e WIDOWER para viúvo |
| granted_limit | int | Limite concedido para pós-pago |
| limit | int | Limite que o cliente escolheu utilizar |
| phone_type | string (10) | Tipo de telefone RESIDENTIAL é PF, COMMERTIAL é PJ e MOBILE |
| country_code | int | DDI em que o telefone se encontra |
| phone | string (10) | Número do telefone |
| area_code | int | DDD em que o telefone se encontra |
| address_type | string (10) | Tipo de endereço, RESIDENTIAL é PF, COMMERTIAL é PJ e Others |
| address | string (50) | Logradouro do endereço |
| number | int | Número do endereço |
| neighborhood | string (50) | Bairro do endereço |
| city | string (50) | Cidade do endereço |
| state | string (2) | Estado do endereço |
| country | string (5) | País do endereço |
| zip_code | string (10) | CEP do endereço |
| mailing_address | boolean | Indica se é o endereço para receber correspondência |
| complementary_address | string (100) | Complemento de informações para o endereço. |
Os campos relacionados à endereço e telefone poderão ser alterados apenas após a submissão da criação da conta.
Passos para Integrar
- Realizar autenticação na API
- Realizar a atualização desejada.
Atualizar informações.
Para atualizar informações na conta, após a autenticação, é necessário enviar a seguinte requisição:
cURL da chamada
{
"application": {
"programId": 1,
"submit": true,
"applicant": {
"personal": {
"name": "John Doe",
"email": "[email protected]"
},
"account": {
"grantedLimit": 1000,
"limit": 1000,
"accountType": "PHYSICAL",
"accountName": "John Doe's Account"
},
"documentNumber": "343354332",
"birthDate": "1984-11-07",
"phones": [
{
"phoneType": "RESIDENTIAL",
"countryCode": "55",
"phone": "22222222",
"areaCode": 11
}
],
"addresses": [
{
"addressType": "RESIDENTIAL",
"address": "Alameda Xingu",
"number": 350,
"neighborhood": " Alphaville Industrial",
"city": "BARUERI",
"state": "SP",
"country": "BRAZIL",
"zipCode": "06455-030",
"mailingAddress": true,
"complementaryAddress": "complemento"
}
]
}
}
}
Sucesso 200
{
"version": 1,
"status": 204
}
Atenção!
Os caracteres especiais e acentuações dos dados preenchidos nos campos printedName e em todos os campos relacionados ao endereço, quando este for indicado como mailingAddress, serão ajustados para evitar erros no processo de embossing do cartão físico.
Significado dos objetos
| Campo | Tipo | Descrição |
|---|---|---|
| programId | int | Id do programa utilizado |
| name | string (100) | Nome do responsável que vai receber os cartões |
| string (100) | Email do responsável que vai receber os cartões | |
| gender | string (1) | Indica o gênero do portador da conta M para masculino e F para feminino |
| maritalStatus | string (10) | Indica o status civil do portador da conta, SINGLE para solteiro, MARRIED para casado, DIVORCED para divorcio e WIDOWER para viúvo |
| grantedLimit | int | Limite concedido para pós-pago |
| limit | int | Limite que o cliente escolheu utilizar |
| accountType | string (30) | Tipo da conta, RESIDENTIAL é PF, COMMERTIAL é PJ e Others |
| accountName | string (50) | Nome destinado a conta para identificação |
| documentNumber | string (20) | Documento do responsável que vai receber os cartões |
| birthDate | string (10) | Data de nascimento do responsável |
| phoneType | string (10) | Tipo de telefone RESIDENTIAL é PF, COMMERTIAL é PJ e MOBILE |
| countryCode | int | DDI em que o telefone se encontra |
| phone | string (10) | Número do telefone |
| areaCode | int | DDD em que o telefone se encontra |
| addressType | string (10) | Tipo de endereço, RESIDENTIAL é PF, COMMERTIAL é PJ e Others |
| address | string (50) | Logradouro do endereço |
| number | int | Número do endereço |
| neighborhood | string (50) | Bairro do endereço |
| city | string (50) | Cidade do endereço |
| state | string (2) | Estado do endereço |
| country | string (5) | País do endereço |
| zipCode | string (10) | CEP do endereço |
| mailingAddress | boolean | Indica se é o endereço para receber correspondência |
| complementaryAddress | string (100) | Complemento de informações para o endereço. |
Updated 2 days ago