Cancel Payment
DELETEDescription: Endpoint that process the cancellation of a payment./v1/payments/:id
Request
Path Parameters
Payment ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
Responses
- 200
- 400
- 401
- 422
Payment canceled successfully.
- application/json
- Schema
- Example (from schema)
Schema
Payment ID.
Possible values: [PENDING
, AUTHORIZED
, REVERTED
, CANCELLED
, SETTLED
]
Payment status.
Payment creation date.
Payment update date.
{
"id": "b28163ec-3d28-4786-a154-7a28ab3600a6",
"status": "CANCELLED",
"created_at": "2025-06-09T21:03:58.071Z",
"updated_at": "2025-06-09T21:03:58.071Z"
}
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.