Notifica a la contraparte y actualiza el estado de una orden peer-to-peer (C2C/P2P) a pagada tras haber completado la transferencia externa del dinero fiduciario.
/sapi/v1/c2c/orderMatch/markOrderAsPaidEste endpoint permite a los compradores y a los bots de pago automatizados confirmar que los fondos fiduciarios han sido transferidos a la cuenta receptora seleccionada por el vendedor. Al ejecutar esta llamada, el estado de la orden cambia de TRADING a BUYER_PAYED (Pagada), se bloquea la ventana de cancelación voluntaria y se notifica al vendedor para que verifique la acreditación del dinero y proceda a liberar las criptomonedas en custodia (escrow).
Sistemas de compra automatizada, integraciones bancarias directas y daemons de dispersión de pagos activan este endpoint inmediatamente después de recibir las confirmaciones de transferencia exitosa por parte de las pasarelas o redes bancarias externas.
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, APP o WEB_MOBILE). |
orderNumber | Body | STRING | Requerido | Identificador único de la orden C2C que se marcará como pagada. |
payId | Body | LONG | Opcional | Identificador de la configuración de pago utilizada por el comprador para efectuar la transferencia bancaria o fiat. |
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. |
Política Estricta de Verificación de Pagos
Solo llama a este endpoint una vez que la transferencia fiduciaria total haya sido confirmada por tu banco o pasarela de pago. Marcar órdenes como pagadas sin haber realizado la transferencia real de fondos constituye una infracción de las normas de la plataforma y puede derivar en la suspensión de la cuenta o penalizaciones por disputas comerciales.
02
Ejemplo de solicitud POST mediante cURL para marcar una orden como pagada.
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/markOrderAsPaid' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
"orderNumber": "202608161234567890",
"payId": 123456
}'03
Ejemplo de respuesta devuelta tras actualizar exitosamente el estado de la orden.
{
"code": "000000",
"message": "success",
"data": {
"orderNumber": "202608161234567890",
"orderStatus": "BUYER_PAYED"
},
"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.orderNumber | STRING | Identificador único de la orden C2C actualizada. |
data.orderStatus | STRING | Estado actualizado del ciclo de vida de la orden (por ejemplo, BUYER_PAYED). |
success | BOOLEAN | Indica el resultado general de la ejecución de la petición. |
04
Flujo de trabajo para marcar una orden C2C como pagada.
Webhooks de Pago Automatizado
Actualiza automáticamente el estado de la orden P2P cuando un callback bancario confirma la emisión de la transferencia saliente.
Botón de Confirmación en el Frontend
Alimenta el botón "Transferido, notificar al vendedor" dentro de interfaces de usuario para clientes y comerciantes.
Bots de Arbitraje de Alta Velocidad
Notifica al vendedor inmediatamente tras procesar el pago vía API para reducir los tiempos de ciclo y asegurar la rotación de capital.