Create new random key.
POST/pix/keys
Create a new EVP key type (random key) to the user.
Request
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
The nonce ID is a UUID (v4) used to uniquely identify the requisition. All requisitions must have an identifier.
Responses
- 201
- 400
- 401
- 422
The pix key returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- EVP: Key type EVP.
- PENDING: Key state PENDING.
- CONFIRMED: Key state CONFIRMED.
- NOT_CONFIRMED: Key state NOT_CONFIRMED.
- ADD_KEY_READY: Key state ADD_KEY_READY.
- READY: Key state READY.
- CANCELED: Key state CANCELED.
- ERROR: Key state ERROR.
- DELETING: Key state DELETING.
- DELETED: Key state DELETED.
- PORTABILITY_PENDING: Key state PORTABILITY_PENDING.
- PORTABILITY_OPENED: Key state PORTABILITY_OPENED.
- PORTABILITY_STARTED: Key state PORTABILITY_STARTED.
- PORTABILITY_READY: Key state PORTABILITY_READY.
- PORTABILITY_CONFIRMED: Key state PORTABILITY_CONFIRMED.
- PORTABILITY_CANCELED: Key state PORTABILITY_CANCELED.
- PORTABILITY_REQUEST_PENDING: Key state PORTABILITY_REQUEST_PENDING.
- PORTABILITY_REQUEST_CANCEL_OPENED: Key state PORTABILITY_REQUEST_CANCEL_OPENED.
- PORTABILITY_REQUEST_CANCEL_STARTED: Key state PORTABILITY_REQUEST_CANCEL_STARTED.
- PORTABILITY_REQUEST_CONFIRM_OPENED: Key state PORTABILITY_REQUEST_CONFIRM_OPENED.
- PORTABILITY_REQUEST_CONFIRM_STARTED: Key state PORTABILITY_REQUEST_CONFIRM_STARTED.
- PORTABILITY_REQUEST_AUTO_CONFIRMED: Key state PORTABILITY_REQUEST_AUTO_CONFIRMED.
- OWNERSHIP_PENDING: Key state OWNERSHIP_PENDING.
- OWNERSHIP_OPENED: Key state OWNERSHIP_OPENED.
- OWNERSHIP_STARTED: Key state OWNERSHIP_STARTED.
- OWNERSHIP_CONFIRMED: Key state OWNERSHIP_CONFIRMED.
- OWNERSHIP_READY: Key state OWNERSHIP_READY.
- OWNERSHIP_CANCELED: Key state OWNERSHIP_CANCELED.
- OWNERSHIP_CONFLICT: Key state OWNERSHIP_CONFLICT.
- OWNERSHIP_WAITING: Key state OWNERSHIP_WAITING.
- CLAIM_NOT_CONFIRMED: Key state CLAIM_NOT_CONFIRMED.
- CLAIM_PENDING: Key state CLAIM_PENDING.
- CLAIM_CLOSING: Key state CLAIM_CLOSING.
- CLAIM_DENIED: Key state CLAIM_DENIED.
- CLAIM_CLOSED: Key state CLAIM_CLOSED.
Pix Key ID.
Pix key.
Possible values: [CNPJ
, CPF
, PHONE
, EMAIL
, EVP
]
Pix Key state:
Possible values: [PENDING
, CONFIRMED
, NOT_CONFIRMED
, ADD_KEY_READY
, READY
, CANCELED
, ERROR
, DELETING
, DELETED
, PORTABILITY_PENDING
, PORTABILITY_OPENED
, PORTABILITY_STARTED
, PORTABILITY_READY
, PORTABILITY_CONFIRMED
, PORTABILITY_CANCELING
, PORTABILITY_CANCELED
, PORTABILITY_REQUEST_PENDING
, PORTABILITY_REQUEST_CANCEL_OPENED
, PORTABILITY_REQUEST_CANCEL_STARTED
, PORTABILITY_REQUEST_CONFIRM_OPENED
, PORTABILITY_REQUEST_CONFIRM_STARTED
, PORTABILITY_REQUEST_AUTO_CONFIRMED
, OWNERSHIP_PENDING
, OWNERSHIP_OPENED
, OWNERSHIP_STARTED
, OWNERSHIP_CONFIRMED
, OWNERSHIP_READY
, OWNERSHIP_CANCELING
, OWNERSHIP_CANCELED
, OWNERSHIP_WAITING
, OWNERSHIP_CONFLICT
, CLAIM_NOT_CONFIRMED
, CLAIM_PENDING
, CLAIM_CLOSING
, CLAIM_DENIED
, CLAIM_CLOSED
]
Pix Key state:
Pix Key created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"key": "f6e2e084-29b9-4935-a059-5473b13033aa",
"type": "EVP",
"state": "READY",
"created_at": "2024-04-24T13:52:51.061Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.