Confirm PIX key claim request (EMAIL/PHONE)

POST

/order/v1/banking/accounts/{accountId}/keys/claims/confirm

• Production
• Sandbox

Confirm the code sent to the e-mail/phone informed on the claim request call and finish requesting the PIX key claim (claimer side).

Authorizations

• Bearer

Parameters

Path Parameters

accountId

required

string format: uuid

Identifier of the account

Header Parameters

idempotency-key

required

string format: uuid

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Request Body ^required

object

validationId

required

Identifier returned by the claim creation call (POST …/keys/claims)

string

Example

a8f2b9c4-1e6a-4c3f-9d7b-2a1e8f9c5d10

token

required

Confirmation code (OTP) received by e-mail/SMS

string

Example

123456

Responses

200

The resource was returned successfully

object

claimId

required

Identifier of the claim, used on subsequent operations.

string

Example

a8f2b9c4-1e6a-4c3f-9d7b-2a1e8f9c5d10

status

required

Status of the claim

string

Example

PENDING

400

object

error

string

Example

INVALID_REQUEST

message

string

details

Array<object>

object

field

string

issue

string

description

string

Example

[
  {
    "field": "field_name",
    "issue": "INVALID",
    "description": "Field is invalid"
  }
]

401

Unauthorized Request

object

error

string

Example

UNAUTHORIZED

message

string

Example

Unauthorized Request

details

Array<object>

object

field

string

issue

string

description

string

Example

[]

500

object

error

string

Example

INTERNAL_ERROR

message

string

details

Array<object>

object

field

string

issue

string

description

string

Example

[]