3.2.2 Отправка OTP-кода клиенту для выдачи товара

На этом этапе продавец отправляет клиенту одноразовый OTP-код (One-Time Password), который используется для подтверждения выдачи заказа. Этот код поступает покупателю по SMS и необходим для финального этапа — подтверждения получения товара.

POST-запрос:

curl --location 'https://api.halykmarket.com/api/merchant/v1/orders' \
--header 'X-Security-Code;' \
--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	поле на данном этапе пустое
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": "ACCEPTED_BY_MERCHANT",
            "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	статус заказа, равный "ACCEPTED_BY_MERCHANT"
posCode	ID точки продаж для забора заказа (не несет бизнес-смысла, равно null)
countPlace	количество мест для доставки (не несет бизнес-смысла, равно 1)
entries	состав заказа
self	ссылка, указывающая на сам заказ. По ней можно будет получить данные конкретного заказа

Вы отправили СМС с OTP-кодом клиенту для подтверждения передачи заказа. Когда клиент сообщит вам код, вы можете завершить заказ.