BINANCE SAPI · C2C

API para Verificar si Está Permitido Cancelar la Orden

Valida previamente si una orden activa de comercio peer-to-peer (C2C/P2P) puede cancelarse de forma segura sin infringir las reglas de intercambio ni acumular penalizaciones en la cuenta.

ENDPOINT

POST /sapi/v1/c2c/orderMatch/checkIfAllowedCancelOrder

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint comprueba la elegibilidad de cancelación de una orden específica en Binance C2C (P2P) antes de enviar la solicitud formal de anulación. Evalúa en tiempo real si la etapa actual del ciclo de vida de la transacción, el estado de la contraparte y la confirmación de pago permiten una cancelación válida.

Bots de trading algorítmico y paneles de control en interfaces de usuario integran esta verificación como paso de seguridad previo a invocar el endpoint de ejecución de cancelación, evitando errores innecesarios en la API y disputas accidentales con la contraparte.

Parámetros de la Solicitud

Parámetros aceptados en el cuerpo (Body) y encabezados HTTP.

Parámetro	Ubicación	Tipo	Requerido	Descripción
`clientType`	Header	STRING	Requerido	Tipo de dispositivo o cliente que realiza la petición (por ejemplo, `WEB` o `APP`).
`orderNumber`	Body	STRING	Requerido	Identificador único de la orden C2C cuya elegibilidad de cancelación se desea evaluar.
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	Header	STRING	Opcional	Identificador de usuario objetivo si se requiere validar el contexto de la cuenta.

Buena Práctica de Pre-Validación

Invoca siempre este chequeo antes de desplegar la ventana modal de confirmación de cancelación en el frontend o de activar secuencias de descarte automático en tus bots para evitar intentos de cancelación fallidos.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para verificar el permiso de cancelación.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/checkIfAllowedCancelOrder' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "orderNumber": "202608161234567890"
}'

Respuesta

Ejemplo de respuesta devuelta tras evaluar exitosamente la elegibilidad.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": true,
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de respuesta estándar de Binance (`"000000"` indica éxito).
`message`	STRING	Mensaje descriptivo del resultado o confirmación de la petición.
`data`	BOOLEAN	Devuelve `true` si la orden puede cancelarse; devuelve `false` en caso contrario.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para validar la elegibilidad de cancelación de una orden C2C.

01 Identificar Orden Obtén el identificador orderNumber a evaluar.

02 Enviar Consulta Envía el POST con el orderNumber al endpoint de verificación.

03 Evaluar Permiso Comprueba si el valor booleano devuelto en data es true.

04 Ejecutar Cancelación Procede a llamar con seguridad a cancelOrder si la acción está permitida.

Casos de Uso Comunes

Validación Previa en Procesos Automáticos

Asegura que las rutinas de anulación de órdenes solo intenten cancelar cuando el backend del exchange lo permita formalmente.

Estado Dinámico del Botón en la UI

Habilita o deshabilita el botón "Cancelar Orden" en la interfaz de usuario en tiempo real según los permisos del servidor.

Prevención de Errores de API

Evita recibir códigos de error 400 o 403 provocados por intentar cancelar órdenes ya pagadas, bloqueadas o en proceso de apelación.