Delete a PIX batch that was not dispatched
Discards a batch and all its items while it is DRAFT or REVIEWED.
No PIX is sent. A batch under review (REVIEWING) or already
dispatched cannot be deleted; dispatched batches stay as payment
history.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
accountId
Account identifier.
batchId
PIX batch identifier (pxb_…) returned by the create endpoint.
Headers
X-Tenant-Id
Tenant context used for authorization and routing.
Idempotency-Key
Optional client-generated idempotency token (recommended for safe retries).
Response
Batch deleted
Errors
403
Forbidden Error
404
Not Found Error
409
Conflict Error