Выдача данных покупок своей системой

Когда подходит

Ключ лицензии, код активации либо учётные данные выпускает ваша система, площадка передаёт их покупателю. Объявление — в категории с выдачей данными, вариант — с ручной выдачей. Без своей системы лицензий ключ выдаёт площадка: покупка программы с цифровой выдачей либо выдачей репозиторием несёт ключ лицензии, программа сверяет его через API площадки.

Порядок

1. Подпишите адрес своей системы на события «Новый заказ» и «Отзыв покупки» — уведомления о событиях.
2. Событие order.purchase.created с delivery DATA несёт fulfillmentId — подзаказ строки покупки.
3. Выпустите ключ и передайте его запросом POST /rest/v1/order/seller/fulfillments/{fulfillmentId}/data-deliveries ключом API с разрешением «Выдача данных покупок» и заголовком Idempotency-Key; тело — value. Покупатель видит данные в «Мои покупки».
4. Замена выданного — тот же запрос с replacedDeliveryId, идентификатором заменяемой записи; замена перезапускает срок подтверждения получения.
5. Событие order.purchase.revoked приходит при возврате покупки — отзовите ключ в своей системе.

Ответ

fulfillmentId, status и deliveries — записи выдачи маской значения с моментом замены. Повтор с тем же Idempotency-Key возвращает прежний ответ без второй выдачи: ключ идемпотентности берите от подзаказа и значения.

Laravel

Сайту на Laravel код писать не нужно — клиент для Laravel принимает события и выдаёт данные.