Create a New Transaction Approval Request
POSTTag: api-baas-post-permissions-transaction-approval-requests-pix-payment-by-keyDescription: To create a new transaction approval request./v1/permissions/transaction-approval-requests/pix-payment-by-key
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.
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
- application/json
Body
required
Decoded pix key ID.
Value in R$ cents.
Payment date.
User defined payment description.
Responses
- 201
- 400
- 401
- 422
The transaction approval request created successfully.
- application/json
- Schema
- Example (from schema)
Schema
Transaction approval request id.
Render request body.
Possible values: [PENDING, APPROVED, CANCELED, EXPIRED]
Transaction approval request state.
Transaction approval request created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"render_request_body": {},
"state": "PENDING",
"created_at": "2026-07-24T17:46:33.212Z"
}
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.