Approve Cash Out

Approves a previously created PIX transfer. Used in the two-step flow (create + approve), where the transfer awaits explicit approval before being sent to SPI.

Endpoint

POST /api/v2/external/pix/cash-out/approve

Headers

Header	Type	Required	Description
Authorization	String	Yes	Bearer {access_token}
Content-Type	String	Yes	application/json
hmac	String	Yes	HMAC-SHA512 signature of the body (hex)

Request Body

Field	Type	Required	Description
transaction_id	String	Yes	Transaction ID returned when creating the cash-out

Approval flow

This endpoint should only be called for transactions with pending_approval status. Transactions that have already been approved or processed will return an error.

Example

curl -X POST https://api.owem.com.br/api/v2/external/pix/cash-out/approve \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "hmac: $HMAC" \
  -d '{
    "transaction_id": "PIXOUT20260309a1b2c3d4e5f6"
  }'

Success Response — 200

{
  "worked": true,
  "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
  "status": "processing",
  "detail": "Transaction approved and sent for processing"
}

Field	Type	Description
worked	Boolean	true indicates the approval was accepted
transaction_id	String	Approved transaction identifier
status	String	New status: processing
detail	String	Descriptive message

Error Response — 404

{
  "worked": false,
  "detail": "Transaction not found"
}

Error Response — 422

{
  "worked": false,
  "detail": "Transaction has already been processed"
}

Create + Approve Flow

1. POST /api/v2/external/pix/cash-out      → status: pending_approval
2. POST /api/v2/external/pix/cash-out/approve → status: processing
3. Webhook or query                          → status: completed / failed

When to use the approval flow

The two-step flow allows you to validate the transaction internally (for example, with compliance rules or limits) before authorizing submission to SPI. If your operation does not require manual approval, the cash-out by key or EMV already sends directly for processing.