Actualizar el estado del pedido

Antes de actualizar el estado del pedido

Antes de actualizar el estado del pedido, asegúrate de que el pedido haya sido pagado. YCloud te enviará el estado de pago mediante este webhook. Recibirás actualizaciones cuando cambie el estado de la transacción iniciada por el usuario. Esto ocurre cuando el estado del pago cambia a captured (cuando el pago se completa con éxito) o a pending (cuando el usuario lo intenta pero aún no ha recibido una señal de transacción exitosa). Ejemplo:

{
  "id": "evt_eEkn26qar3nOB8md",
  "type": "whatsapp.payment.updated",
  "apiVersion": "v2",
  "createTime": "2024-10-10T07:08:00.000Z",
  "whatsappPayment": {
    "wabaId": "WABA-ID",
    "referenceId": "<reference-id>",
    "status": "captured | pending",
    "transactions": [
      {
        "id": "<transaction-id>",
        "type": "billdesk | payu | razorpay | zaakpay",
        "status": "pending | success | failed",
        "createdTimestamp": 1728544066000,
        "updatedTimestamp": 1728544066000,
        "amount": {
          "value": 21000,
          "offset": 100
        },
        "currency": "INR",
        "methodType": "upi | card | wallet | netbanking",
        "error": {
          "code": "error-code",
          "reason": "error-reason"
        }
      }
    ]
  }
}

Valor de enumeración del estado del pedido

Valor	Descripción
`pending`	El usuario aún no ha pagado con éxito
`processing`	Pago del usuario autorizado, el comerciante/socio está procesando el pedido, prestando el servicio, etc.
`partially-shipped`	Una parte de los productos del pedido ha sido enviada por el comerciante
`shipped`	Todos los productos del pedido han sido enviados por el comerciante
`completed`	El pedido se ha completado y no se espera ninguna acción adicional por parte del usuario o del socio/comerciante
`canceled`	El socio/comerciante desea cancelar el mensaje `order_details` para el pedido/factura. La actualización del estado fallará si ya existe un pago `successful` o `pending` para este mensaje `order_details`

Captura de pantalla del producto de YCloud

¿Cómo notificar a los clientes sobre los cambios en el estado del pedido?

Puedes notificar a los clientes enviando una plantilla de Actualizaciones de estado de pedido cuando un pedido esté confirmado o enviado. p. ej., cuando se ha enviado un pedido, puedes enviar una plantilla de Order Status Updates al cliente, informándole sobre el estado actualizado.

Crear plantilla de actualización del estado del pedido

El requisito previo es haber vinculado tu cuenta de pago.

Crear mediante API

Referencia de la API: Crear una plantilla Ejemplo de creación: Crear una plantilla

Crear en YCloud

Visita https://www.ycloud.com/console/#/app/dashboard/template

Enviar mensaje de actualizaciones del estado del pedido

Referencia de la API: Enviar un mensaje directamente ejemplo:

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "order_status_template",
    "language": {
      "policy": "deterministic",
      "code": "en_US"
    },
    "components": [
      {
        "type": "order_status",
        "parameters": [
          {
            "type": "order_status",
            "order_status": {
              "reference_id": "<reference_id_value>",
              "order": {
                "status": "processing | partially_shipped | shipped | completed | canceled",
                "description": "<OPTIONAL_DESCRIPTION>"
              }
            }
          }
        ]
      }
    ]
  }
}'

Visión general

Inicio rápido

WhatsApp Business Platform

Gestión de cuentas de WhatsApp

Bandeja de entrada

Contacto

Llamadas

Campaña

Recorrido

Agentes

CTWA (Anuncios de clic para WhatsApp)

Tienda

WhatsApp Pay

Integraciones

Desarrollador

Gestión de cuenta

Precios y facturación

Alianzas

Soporte

Actualizar el estado del pedido

Antes de actualizar el estado del pedido

Valor de enumeración del estado del pedido

¿Cómo notificar a los clientes sobre los cambios en el estado del pedido?

Crear plantilla de actualización del estado del pedido

Enviar mensaje de actualizaciones del estado del pedido

​Antes de actualizar el estado del pedido

​Valor de enumeración del estado del pedido

​¿Cómo notificar a los clientes sobre los cambios en el estado del pedido?

​Crear plantilla de actualización del estado del pedido

​Enviar mensaje de actualizaciones del estado del pedido

Antes de actualizar el estado del pedido

Valor de enumeración del estado del pedido

¿Cómo notificar a los clientes sobre los cambios en el estado del pedido?

Crear plantilla de actualización del estado del pedido

Enviar mensaje de actualizaciones del estado del pedido