DOCS
Checkout•
InicioReferencia de la API Checkout REST API Actualizar número de pedido

Actualizar número de pedido

Descubra cómo funciona el endpoint para actualizar un número de pedido.

El endpoint updateMerchantOrderId se utiliza para actualizar un pedido en el sistema Zonos con el ID de pedido de su tienda para una mejor conciliación, comunicación y auditoría.

Endpoint 

POST | https://api.iglobalstores.com/v1/updateMerchantOrderId

Solicitud HTTPS

Campo↕Notas↕
Método HTTPPOST
URL del endpointhttps://api.iglobalstores.com/v1/updateMerchantOrderId
ProtocoloHTTPS
Formato del mensajeJSON
Encabezado HTTP AcceptAccept: application/json
Encabezado HTTP Content-TypeContent-Type: application/json

Pares clave/valor JSON en el cuerpo de la solicitud

1{
2 "store": "999",
3 "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
4 "orderId": "999-9999",
5 "merchantOrderId": "12-34567"
6}

Definiciones JSON de la solicitud

Campo↕Notas↕
merchantOrderId REQUERIDOEste parámetro se utiliza para pasar el ID de pedido interno de su tienda al pedido en el sistema Zonos. Esto se recomienda para una mejor conciliación, comunicación y auditoría.string
orderId REQUERIDOEl ID de pedido de Zonos: puede enviarse con o sin el ID de su tienda y el guion (Ejemplo: 123-45678 o 45678). Nota: Después de completar el pedido y el pago, el cliente será redirigido a una página de confirmación / agradecimiento alojada en su dominio. La URL contendrá un parámetro de cadena de consulta "orderId" que contendrá este valor.integer / string
secret REQUERIDOGUID secreto de la API proporcionado por Zonos.string
store REQUERIDOID de tienda proporcionado por Zonosinteger

Respuesta HTTPS

1{
2 "success": "Updated Order: 99999 with new merchantOrderId: 12-34567"
3}

Respuestas HTTP de error

Código de error↕Definición↕
406 - Not AcceptableEntidad HTML. El encabezado HTTP "Accept" no es válido.
415 - Unsupported media typeEntidad HTML. El encabezado HTTP "Content-Type" no es válido.
200"error":"could not parse input"
200"error":"Parameter orderId is required to processUpdateMerchantOrderId"
200"error":"Parameter merchantOrderId is required to updateMerchantOrderId."
200"error":"orderId: 999-99999 is not a valid orderId"
200"error":"Could not retrieve order to updateMerchantOrderId for orderId: 999-99999"
200"error":"Could not process update merchant order id."
200"error":"Invalid security credentials"

Definiciones JSON de la respuesta

Mensaje↕Definición↕
errorEste parámetro solo estará presente en la respuesta cuando haya ocurrido un error y contendrá una descripción de la causa.string
successEste parámetro contendrá un resumen de la actualización.string

¿Fue útil esta página?

Obtener soporte·Documentos legales·© 2026 Zonos
En esta página:
  • Actualizar número de pedido
  • Endpoint