> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Обновление статуса заказа

## Перед обновлением статуса заказа

Перед обновлением статуса заказа **убедитесь, что заказ оплачен**. YCloud отправит вам статус оплаты через этот [webhook](/ru/api-reference/webhooks/test-webhooks). 

Вы будете получать обновления при изменении статуса транзакции, инициированной пользователем. Это происходит, когда статус платежа меняется на `captured` (когда платеж успешно завершен) или `pending` (когда пользователь совершил попытку, но подтверждение успешной транзакции еще не получено).

Пример:

```
{
  "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"
        }
      }
    ]
  }
}
```

## Значения перечисления статусов заказа

| Значение | Описание |
| - | - |
| `pending` | Пользователь еще не выполнил успешную оплату |
| `processing` | Платеж пользователя авторизован, продавец/партнер выполняет заказ, оказывает услугу и т. д. |
| `partially-shipped` | Часть товаров из заказа была отправлена продавцом |
| `shipped` | Все товары из заказа были отправлены продавцом |
| `completed` | Заказ завершен, дальнейших действий от пользователя или партнера/продавца не требуется |
| `canceled` | Партнер/продавец хочет отменить сообщение `order_details` для заказа/счета. Обновление статуса завершится ошибкой, если для этого сообщения `order_details` уже существует платеж `successful` или `pending` |

<img src="https://mintcdn.com/lchnan/WD-ixrYVrqB7b7aQ/product-assets/3be4b91634-image-596.webp?fit=max&auto=format&n=WD-ixrYVrqB7b7aQ&q=85&s=a91122cebfd41c2afbedd93da2cf01f3" alt="Скриншот продукта YCloud" width="765" height="307" data-path="product-assets/3be4b91634-image-596.webp" />

## Как уведомлять клиентов об изменении статуса заказа?

Вы можете уведомлять клиентов, отправляя шаблон обновления статуса заказа, когда заказ подтвержден или отправлен.

Например, когда заказ отправлен, вы можете отправить клиенту шаблон **Order Status Updates** , информируя его об обновленном статусе.

### Создание шаблона обновления статуса заказа

<Info>
  Необходимым условием является привязка вашего платежного аккаунта.
</Info>

1. Создание через API

Справочник по API: [Создать шаблон](/api-reference/whatsapp-templates/create-a-template)

Пример создания: [Создать шаблон](/api-reference/whatsapp-templates/create-a-template)

2. Создание в YCloud

Перейдите в [https://www.ycloud.com/console/#/app/dashboard/template](https://www.ycloud.com/console/#/app/dashboard/template)

<img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/9b7f2f2c98-image-597.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=69883deedf4517a575e99109af6fa9d9" alt="Скриншот продукта YCloud" width="1592" height="827" data-path="product-assets/9b7f2f2c98-image-597.webp" />

### Отправка сообщения с обновлением статуса заказа

Справочник по API: [Отправить сообщение напрямую](/api-reference/whatsapp-messages/send-a-message-directly)

Пример:

```
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>"
              }
            }
          }
        ]
      }
    ]
  }
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.