Change pix automatic charge status (test only)
POSTTag: api-baas-change-status-pix-automatic-chargeDescription: TEST-ONLY endpoint, available only in non-production environments (development, staging, local, test). Directly sets the charge to one of 3 possible statuses (PAID, NOT_PAID, CANCELED). Not present in production./v1/pix/scheduled-payments/automatic-charges/:id/change-status
Request
Path Parameters
Charge unique id.
Header Parameters
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
Possible values: [PAID, NOT_PAID, CANCELED]
New status to simulate.
Responses
- 200
- 400
- 422
Charge status successfully updated.
- application/json
- Schema
- Example (from schema)
Schema
Charge ID.
Possible values: [PENDING_WAITING, PENDING_CONFIRMED, CREATED, CREATED_FAILED, PAID, NOT_PAID, WAITING_CANCELLATION, CANCELED, CANCELED_FAILED]
Charge status.
Charge update date.
{
"id": "fb96cf13-4600-4d21-ad67-40fc05ac3a8d",
"status": "PAID",
"updated_at": "2026-09-21T10:23:41.691Z"
}
If any required params are missing or has invalid format or type.
If the charge was not found, or the requested status transition is invalid for its current state.