This endpoint is used to cancel a payment authorization before the funds are captured. It is applicable when a transaction is on hold (e.g., pre-authorized card payment) and the merchant decides not to proceed with the capture.
🚫 Cancel a Hold
Endpoint:
POST https://secure.carusell.world/pay/void
🕒 Recent Requests
Log in with your api_key to view request and response history.
📥 Request Structure
You must include two required parameters:
data: A base64-encoded JSON string with details of the authorization to cancel.sign: A HMAC-SHA256 signature of thedata, created using yoursecret_key.
Signature formula:
sign = HMAC_SHA256(base64(data), secret_key)🔁 Recurrent Payments
Endpoint:
POST https://secure.carusell.world/pay/recurrent
🔧 Body Parameters
| Name | Type | Required | Description |
|---|---|---|---|
data | string | ✅ | A base64-encoded JSON string with the transaction or authorization ID to cancel |
sign | string | ✅ | HMAC signature generated using the encoded data and your secret_key |
✅ Response
Status Code: 200 OK
Example:
{
"status": "voided",
"transaction_id": "txn_987654",
"message": "Authorization successfully canceled"
}
If the transaction was already captured, use the refund endpoint instead.