Pix Key creation for an Alias

Request

ENDPOINT

/account/ACCOUNT_KEY/alias/ALIAS_KEY/pix_key

METHOD

POST

Request Body - Key type 'random_key'

{
  "request_control_key": "3d3d0083-ac71-46f0-8a90-c00a157a4893",
  "pix_key_type": "random_key"
}

Request Body - Key type CPF

{
  "request_control_key": "3d3d0083-ac71-46f0-8a90-c00a157a4893",
  "pix_key_type": "cpf",
  "pix_key": "67824450007"
}

Request Path Params

Field	Type	Description	Characters
account_key	uuidv4	Unique account key.	36
alias_key	uuidv4	Unique alias key.	36

Request Body Params

Field	Type	Description	Max. Characters
request_control_key *	string	UUID4 for querying about the made request.	36
pix_key_type *	string	Definition of the type of key to be created. Possible values: 'cpf', 'cnpj', 'email', 'phone_number', 'random_key'	10
pix_key	string	Value of the PIX key to be created. Should not be sent for 'random_key' types.	10

Pix Key Types

The pix_key sent in the request can be a CPF, CNPJ, Email, or phone number, following these formats: CPF: Integer with 11 digits.

CNPJ: Integer with 14 digits.

Email: Text containing at least one “@”.

Phone: Text containing the following values: “+55” + “Mobile DDD“ + “Complete Mobile Number with a minimum of 8 and a maximum of 9 digits”. E.g., “+5511987654321“.

Response

STATUS

200

Response Body

{
  "pix_key": "asra-4cd6-4c04-9651-1c0a2c30d7dd",
  "pix_key_status": "active",
  "created_at": "2021-12-06T21:16:11.001Z",
  "pix_key_type": "random_key"
}

Response Body Params

Field	Type	Description	Max. Characters
pix_key	string	Value of the created PIX key.	200
pix_key_status	string	Activation status of the PIX key. Can be "active", "inactive" or "pending"	8
created_at	datetime Zulu	Date of creation of the request.	20

Pix Key Types

The pix_key sent in the request response can be a CPF, CNPJ, Email, phone number, or random key, following these formats: CPF: Integer with 11 digits.

CNPJ: Integer with 14 digits.

Email: Text containing at least one “@”.

Phone: Text containing the following values: “+55” + “Mobile DDD“ + “Complete Mobile Number with a minimum of 8 and a maximum of 9 digits”. E.g., “+5511987654321“.

Random key: UUIDV4.

STATUS

4XX

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "description em portuguese",
  "code": "codigo",
  "extra_fields": {}
}

HTTP Code	QI Code code	Title title	Description (eng) Description	Description (ptbr) translation
403	PIX000080	Not enough permission	The selected agent is not an Pix Indirect Participant	O agente selecionado não é um Participante Indireto do Pix
404	PIX000082	Alias not found	Alias {alias_key} not found	Alias {alias_key} não encontrado