Checkouts sessions
Checkout Sessions - Cancel
Authorization
SelectKeyAuth selectkey<token>
API key for all authenticated requests. Send your key in the selectkey header (e.g. sandbox sl_test_…, production sl_live_…).
In: header
Path Parameters
sessionId*string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/checkouts/sessions/res_session_abc123"{
"object": "checkout.session",
"id": "sess_a1b2c3d4e5f6789012ab",
"url": "https://checkout.selectwin.io/p/live/sess_a1b2c3d4e5f6789012ab",
"status": "expired",
"ambient": "live",
"source": "api",
"currency": "BRL",
"lineItems": [
{
"id": "var_abc123",
"name": "Curso Premium",
"quantity": 1,
"unitPrice": 49700,
"currency": "BRL",
"isOrderbump": false,
"isUpsell": false,
"metadata": {
"sku": "ABC-123"
},
"externalReference": "erp-ref-9"
}
],
"totals": {
"amount": 46523,
"discount": 5167,
"shipping": 0,
"tax": 0
},
"coupons": [
{
"code": "DESCONTO10",
"type": "percentage",
"value": 10
}
],
"customer": {
"email": "[email protected]",
"fullName": "Maria Silva",
"document": {
"number": "12345678909",
"type": "cpf"
},
"telephone": {
"countryCode": "55",
"areaCode": "11",
"number": "999998888"
}
},
"address": {
"postcode": "01310-100",
"street": "Av. Paulista",
"number": "1000",
"district": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"country": "BR"
},
"paymentMethods": [
"pix",
"credit",
"billet"
],
"paymentSelection": null,
"redirectUrls": {
"paid": "https://seller.com/obrigado",
"refused": "https://seller.com/recusado",
"pending": "https://seller.com/processando"
},
"utm": {
"source": "newsletter",
"campaign": "junho"
},
"metadata": {
"erpOrderId": "9921"
},
"customInputs": null,
"integrationType": "shopify",
"integrationId": "cmp_shop_123",
"externalTransactionId": "pedido-7781",
"firstInitialization": true,
"online": false,
"expiresAt": "2026-06-12T12:00:00.000Z",
"createdAt": "2026-06-08T12:00:00.000Z",
"updatedAt": "2026-06-08T12:00:00.000Z"
}Empty
{
"error": {
"status": "Bad Request",
"statusCode": 400,
"category": "validation",
"message": "Validation errors occurred",
"details": "One or more parameters are invalid or out of range. Please check the parameters and try again.",
"params": [
{
"payment[currency]": "currency must be one of [BRL]"
},
{
"amount": "amount is required"
}
],
"code": "invalidParameters",
"resource": "client"
}
}{
"error": {
"status": "Unauthorized",
"statusCode": 401,
"category": "authentication",
"message": "Unauthorized",
"details": "Authentication failed. The provided API key is invalid or does not have permission to operate.",
"code": "unauthorized"
}
}{
"error": {
"status": "Forbidden",
"statusCode": 403,
"category": "authorization",
"message": "Forbidden",
"details": "Access denied. This may be due to IP blocks, domain restrictions, or insufficient permissions.",
"code": "forbidden"
}
}{
"error": {
"status": "Not Found",
"statusCode": 404,
"category": "client",
"message": "Not Found",
"details": "The requested resource was not found on the server.",
"code": "notFound"
}
}{
"error": {
"status": "Unprocessable Entity",
"statusCode": 422,
"category": "validation",
"message": "Unprocessable Entity",
"details": "The request was understood, but contains invalid data that could not be processed.",
"code": "unprocessableEntity"
}
}{
"error": {
"status": "Too Many Requests",
"statusCode": 429,
"category": "rate_limit",
"message": "Too Many Requests",
"details": "The number of requests exceeded the limit allowed for the IP or user.",
"retryAfterMinutes": 60,
"code": "tooManyRequests"
}
}{
"error": {
"status": "Internal Server Error",
"statusCode": 500,
"category": "server",
"message": "Server error.",
"details": "An internal server error occurred. Please try again later.",
"code": "serverError",
"resource": "server"
}
}