Cancela una orden activa de comercio peer-to-peer (C2C/P2P) indicando el número de orden, el código estandarizado del motivo de cancelación y observaciones contextuales opcionales.
/sapi/v1/c2c/orderMatch/cancelOrderEste endpoint permite al comprador o a un bot de trading cancelar una orden C2C (P2P) activa que aún no ha sido marcada como pagada. Al procesarse la cancelación, las criptomonedas bloqueadas en el depósito de garantía (escrow) de Binance se liberan automáticamente y regresan al saldo disponible del vendedor o al inventario de su anuncio.
Los sistemas de trading automatizado utilizan este endpoint para gestionar ventanas de pago vencidas, tiempos de espera agotados por parte de la contraparte o solicitudes manuales de cancelación emitidas por el usuario final.
01
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 que se desea cancelar. |
orderCancelReasonCode | Body | INT | Opcional | Código numérico estandarizado que explica el motivo de la cancelación. |
orderCancelAdditionalInfo | Body | STRING | Opcional | Observaciones adicionales o descripción textual justificando la cancelación. |
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. |
Límites de Cancelación Diarios
Cancelar un número excesivo de órdenes dentro de una ventana de 24 horas puede restringir temporalmente la capacidad del usuario para generar nuevas órdenes en el mercado P2P. Asegúrate de que la lógica de cancelación en tus sistemas se ejecute únicamente cuando sea estrictamente necesario.
02
Ejemplo de solicitud POST mediante cURL para cancelar una orden P2P.
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/cancelOrder' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
"orderNumber": "202608161234567890",
"orderCancelReasonCode": 1,
"orderCancelAdditionalInfo": "Método de pago no disponible"
}'03
Ejemplo de respuesta devuelta tras cancelar la orden exitosamente.
{
"code": "000000",
"message": "success",
"data": null,
"success": true
}| 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 | NULL / VOID | Carga útil vacía devuelta tras completar con éxito la cancelación de la orden. |
success | BOOLEAN | Indica el resultado general de la ejecución de la petición. |
04
Flujo de trabajo para cancelar una orden de intercambio C2C.
Gestión de Tiempos de Pago Vencidos
Cancela órdenes de compra de forma automática cuando pasarelas de pago externas o transferencias bancarias no se completan dentro del plazo límite.
Cancelación Iniciada por el Usuario
Ofrece botones de desistimiento en la interfaz de tu aplicación para compradores que decidan no concretar la transferencia manual.
Recuperación Ante Errores en Bots
Cancela órdenes estancadas o con discrepancias de parámetros de forma programática antes de desbloquear los saldos asignados a tus estrategias.