Передача ключей цифровых товаров
POST/v2/campaigns/:campaignId/orders/:orderId/deliverDigitalGoods
Передает ключи цифровых товаров, которые покупатель заказал и оплатил. После выполнения запроса Маркет отправит ему письмо с ключами и инструкциями по активации. Если письмо будет доставлено, Маркет переведет заказ в финальный статус DELIVERED.
{% note tip "После передачи кода покупателю статус заказа изменится не сразу" %}
Подключите API-уведомления — Маркет отправит вам запрос POST notification, когда заказ перейдет в статус DELIVERED.
{% endnote %}
Ключ нужно передать в течение 30 минут после перехода заказа в статус PROCESSING.
Если в один заказ входят несколько ключей, передавайте их все в одном запросе.
Каждый товар с уникальным id передавайте в виде отдельного элемента в массиве items, а ключи товара — в массиве codes.
{% cut "Пример" %}
{
"items": [
{
"id": 1,
"codes": [
"code1", "code2", "code3"
],
"slip": "slip",
"activate_till": "2025-02-18"
},
{
"id": 2,
"codes": [
"code4", "code5", "code6"
],
"slip": "slip",
"activate_till": "2025-02-18"
}
]
}
{% endcut %}
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 420
- 500
Пустой ответ.
{% note warning "Ответ 200 сам по себе не значит, что ключи переданы покупателю" %}
Если письмо с ключами удалось доставить, Маркет переведет заказ в финальный статус DELIVERED.
Статус заказа можно узнать с помощью метода POST v1/businesses/{businessId}/orders.
{% endnote %}
Запрос содержит неправильные данные. Подробнее об ошибках при работе с заказами
В запросе не указаны данные для авторизации. Подробнее об ошибке
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Запрашиваемый ресурс не найден. Подробнее об ошибке
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Внутренняя ошибка Маркета. Подробнее об ошибке