Alteração de contato de pessoa

Request

Token Request

ENDPOINT

/baas/token_request

MÉTODO

POST

Request Body

{
  "contact_type": "email",
  "person_contact_update": {
    "person_key": "3ea7f034-f06b-4e28-ae19-7c23694f546b",
    "phone_number": {
      "country_code": "55",
      "area_code": "888",
      "number": "988887777"
    }
  },
  "agent_document_number": "99988877765"
}

Token Validation

ENDPOINT

/baas/movement_validation

MÉTODO

POST

Request Body

{
  "token": "123456",
  "person_contact_update": {
    "person_key": "3ea7f034-f06b-4e28-ae19-7c23694f546b",
    "phone_number": {
      "country_code": "55",
      "area_code": "888",
      "number": "988887777"
    }
  }
}

Body Params

Campo	Tipo	Descrição	Caracteres
contact_type *	string	(/baas/token_request) Forma de envio escolhida para o token. Para envios de sms, apenas números brasileiros (+55) receberão a mensagem.	"sms"
token *	string	(/baas/token_validation) Código de seis (6) dígitos enviado ao aprovador da operação. Ex: "123456"	6
person_contact_update	Object	Informações de alteração de contato	Objeto person_contact_update
agent_document_number	string	CPF de um dos administradores da conta que receberá o SMS para validação Ex: "99977766654"	11

Objeto person_contact_update

Campo	Tipo	Descrição	Caracteres
person_key *	string	Chave de identificação da pessoa física. Formato uuid v4. Ex: 1ed6dc4e-a0a8-42bb-8cc0-0bb3b0233fb9	36
phone_number	Object	Objeto contendo informações do novo número de telefone	Objeto phone_number
email	string	Novo email a ser cadastrado

Objeto phone_number

Campo	Tipo	Descrição	Caracteres
country_code *	string	DDI do país	1-3
area_code *	string	DDD da área do telefone	1-3
number *	string	Número de telefone	10

Formas de contato implementadas

contact_type permitido para esta operação é sms e email.

Limitações para modificação

Para alteração de número de telefone a forma de contato deve ser email e para a alteração de email, a forma de contato deve ser sms.

Número a receber token

A pessoa física que está tendo seu cadastro alterado receberá o token.

Response

Token Request

STATUS

200

Response Body

{}

STATUS

400

Response Body: Tipo de contato não implementado

{
  "title": "Bad Request",
  "description": "Contact type {contact_type} not allowed",
  "translation": "Forma de contato por {contact_type} não permitida",
  "code": "ACC000152",
  "additional_data": {}
}

STATUS

400

Response Body: Contato não existente inválido

{
  "title": "Bad Request",
  "description": "Contact does not exist",
  "translation": "Contato nao existe",
  "code": "ACC000135",
  "additional_data": {}
}

Token Validation

STATUS

200

Response Body

{
  "hash": "8e11308086ea336edb113a6ff5746778",
  "return_response": {
    "email": "test.email@email.com",
    "person_key": "110b3ee3-cae2-44de-ba2c-494434d5cb18",
    "phone": [
      {
        "area_code": "11",
        "country_code": "55",
        "number": "988887777"
      }
    ]
  },
  "validation": true
}

STATUS

401

Response Body: Token enviado expirado

{
  "title": "Unauthorized",
  "description": "Expired token",
  "translation": "Token Expirado",
  "code": "ACC000134",
  "additional_data": {}
}

STATUS

401

Response Body: Token enviado inválido

{
  "title": "Unauthorized",
  "description": "Invalid token",
  "translation": "Token Inválido",
  "code": "ACC000133",
  "additional_data": {}
}