Developers

Orders

Markdown

Deliver digital content by hand

Gives the customer a text, such as a subscription login, on the order page and by email when the order has one, and marks the order as delivered.

POST/stores/{storeId}/v1/orders/{id}/digital-delivery

Use it for what the store cannot deliver by itself. content is up to 5,000 characters. An order held for review is delivered by changing its status to completed instead. See Digital products and delivery.

Path parameters

idstringrequired

Headers

Idempotency-Keystringrequired

Request body

contentstringrequired
What the customer sees on the order page and receives by email.

Response

dataobjectrequired
order_idstring
deliveredboolean
true
executionobject
Who executed the request: the app, version, installation and store. Field names here are camelCase.
appIdstring (uuid)
versionIdstring (uuid)
installationIdstring (uuid)
storeIdstring (uuid)
requestIdstring (uuid)
generationinteger
routeEpochinteger
appAuthEpochinteger
grantRevisioninteger
metaobjectrequired
request_idstring (uuid)
The request ID; include it in any support request.

Errors

HTTPCodeMeaning
400IDEMPOTENCY_KEY_REQUIREDNo Idempotency-Key header.
404RESOURCE_NOT_FOUNDThe ID does not exist in this store.
409ORDER_NOT_PAIDThe order is not paid.
409ORDER_REVIEW_HOLDThe order is held for review. Change its status to completed to deliver its codes.
409ORDER_TERMINALThe order is cancelled or refunded.
409STORE_RULE_REFUSEDA store rule refused the command. Read the resource before you try again.
422INVALID_INPUTcontent is empty or too long.
403SCOPE_REQUIREDThe token does not carry the required scope.
503APPS_SCOPE_RUNTIME_NOT_READYThe resource is not enabled on this merchant's store yet.

Shared codes are listed in Errors.

    ↑↓ moveEnter openEsc close