3.2.3 Завершение заказа

На этом шаге вы подтверждаете, что клиент получил свой заказ. После того как покупатель назовет вам OTP-код, который пришел ему по СМС, вы вводите этот код в запрос, чтобы завершить заказ в системе.

POST-запрос:

curl --location 'https://api.halykmarket.com/api/merchant/v1/orders' \
--header 'X-Security-Code: 4007' \
--header 'X-Send-Code: true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ваш токен' \
--data '{
  "data": {
    "type": "orders",
    "id": "11111111",
    "attributes": {
        "code": "1111111111-1",
        "status": "COMPLETED"
    }
  }
}'

Атрибуты запроса:

Наименование	Значение
X-Security-Code	4 цифры OTP-кода, который сообщает клиент
X-Send-Code	равно true
type	необходимый атрибут, равный "orders"
id	ID заказа из ответа на этапе получения списка новых заказов
code	номер заказа
status	статус заказа, равный "COMPLETED"

Для обращения на тестовый сервер, используйте URL: https://test2-api.halykmarket.com/api/merchant/v1/orders

Ответ сервера:

Шаблон ответа:

{
    "data": {
        "type": "orders",
        "id": "11111111",
        "attributes": {
            "code": "1111111111-1",
            "status": "COMPLETED",
            "posCode": null,
            "countPlace": 1
        },
        "relationships": {
            "entries": {
                "links": {
                    "self": "/api.halykmarket.com/api/merchant/v1/orders/11111111/relationships/entries",
                    "related": "/api.halykmarket.com/api/merchant/v1/orders/11111111/entries"
                }
            }
        }
    }
}

Атрибуты ответа:

Наименование	Описание
type	необходимый атрибут, равный "orders"
id	ID заказа из ответа на этапе получения списка новых заказов
code	номер заказа
status	статус заказа, равный "COMPLETED"
posCode	ID точки продаж для забора заказа (не несет бизнес-смысла, равно null)
countPlace	количество мест для доставки (не несет бизнес-смысла, равно 1)
entries	состав заказа
self	ссылка, указывающая на сам заказ. По ней можно получить данные конкретного заказа

Заказ завершен.