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:

CampoTipoDescrição
due_dateintDia fechamento da fatura
namestring (100)Nome do responsável que vai receber os cartões
emailstring (100)E-mail do responsável que vai receber os cartões
genderstring (1)Indica o gênero do portador da conta M para masculino e F para feminino
marital_statusstring (10)Indica o status civil do portador da conta, SINGLE para solteiro, MARRIED para casado, DIVORCED para divorcio e WIDOWER para viúvo
granted_limitintLimite concedido para pós-pago
limitintLimite que o cliente escolheu utilizar
phone_typestring (10)Tipo de telefone RESIDENTIAL é PF, COMMERTIAL é PJ e MOBILE
country_codeintDDI em que o telefone se encontra
phonestring (10)Número do telefone
area_codeintDDD em que o telefone se encontra
address_typestring (10)Tipo de endereço, RESIDENTIAL é PF, COMMERTIAL é PJ e Others
addressstring (50)Logradouro do endereço
numberintNúmero do endereço
neighborhoodstring (50)Bairro do endereço
citystring (50)Cidade do endereço
statestring (2)Estado do endereço
countrystring (5)País do endereço
zip_codestring (10)CEP do endereço
mailing_addressbooleanIndica se é o endereço para receber correspondência
complementary_addressstring (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

  1. Realizar autenticação na API
  2. 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

CampoTipoDescrição
programIdintId do programa utilizado
namestring (100)Nome do responsável que vai receber os cartões
emailstring (100)Email do responsável que vai receber os cartões
genderstring (1)Indica o gênero do portador da conta M para masculino e F para feminino
maritalStatusstring (10)Indica o status civil do portador da conta, SINGLE para solteiro, MARRIED para casado, DIVORCED para divorcio e WIDOWER para viúvo
grantedLimitintLimite concedido para pós-pago
limitintLimite que o cliente escolheu utilizar
accountTypestring (30)Tipo da conta, RESIDENTIAL é PF, COMMERTIAL é PJ e Others
accountNamestring (50)Nome destinado a conta para identificação
documentNumberstring (20)Documento do responsável que vai receber os cartões
birthDatestring (10)Data de nascimento do responsável
phoneTypestring (10)Tipo de telefone RESIDENTIAL é PF, COMMERTIAL é PJ e MOBILE
countryCodeintDDI em que o telefone se encontra
phonestring (10)Número do telefone
areaCodeintDDD em que o telefone se encontra
addressTypestring (10)Tipo de endereço, RESIDENTIAL é PF, COMMERTIAL é PJ e Others
addressstring (50)Logradouro do endereço
numberintNúmero do endereço
neighborhoodstring (50)Bairro do endereço
citystring (50)Cidade do endereço
statestring (2)Estado do endereço
countrystring (5)País do endereço
zipCodestring (10)CEP do endereço
mailingAddressbooleanIndica se é o endereço para receber correspondência
complementaryAddressstring (100)Complemento de informações para o endereço.