Endpoint
POST | https://api.iglobalstores.com/v1/updateMerchantOrderId
Solicitud HTTPS
| Campo↕ | Notas↕ |
|---|---|
| Método HTTP | POST |
| URL del endpoint | https://api.iglobalstores.com/v1/updateMerchantOrderId |
| Protocolo | HTTPS |
| Formato del mensaje | JSON |
| Encabezado HTTP Accept | Accept: application/json |
| Encabezado HTTP Content-Type | Content-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 REQUERIDO | Este 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 REQUERIDO | El 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 REQUERIDO | GUID secreto de la API proporcionado por Zonos.string |
store REQUERIDO | ID 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 Acceptable | Entidad HTML. El encabezado HTTP "Accept" no es válido. |
| 415 - Unsupported media type | Entidad 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↕ |
|---|---|
error | Este parámetro solo estará presente en la respuesta cuando haya ocurrido un error y contendrá una descripción de la causa.string |
success | Este parámetro contendrá un resumen de la actualización.string |
Actualizar número de pedido
Descubra cómo funciona el endpoint para actualizar un número de pedido.
El endpoint
updateMerchantOrderIdse 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.