Developers
Deliveries12

Duplicate a delivery

POST/sales/deliveries/{delivery_id}/copies

Creates a copy of the delivery and returns it.

The copy does not include the gateway product codes or the secret, because these identify the original delivery with the gateway. Configure them on the copy before using it to process sales.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

delivery_id*string

Public ID of the delivery, prefixed with dlv_.

Header Parameters

Idempotency-Key*string

Client-generated key that makes the request safe to retry. Must be 1 to 128 characters from [A-Za-z0-9._:-]. Required by this operation: a missing key returns idempotency_key_required, and a malformed key returns idempotency_key_invalid. Repeating the request with the same key and the same body returns the stored result with Idempotent-Replayed: true.

X-Client-Request-Id?string

Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/sales/deliveries/string/copies" \  -H "Idempotency-Key: string"
{  "data": {    "created_at": "2019-08-24T14:15:22Z",    "enrollments_count": 0,    "external_ids": [      "string"    ],    "gateway": "string",    "hidden": true,    "id": "string",    "kind": "one_time",    "name": "string",    "object": "delivery",    "postback_url": "string",    "products_count": 0,    "revision": "string",    "secret": {      "configured": true    },    "status": "active",    "tags_count": 0,    "updated_at": "2019-08-24T14:15:22Z"  }}

Update a delivery PATCH

Updates an existing delivery. Changing `status` requires the `deliveries.archive` permission in addition to `deliveries.update`. Archiving a delivery stops it from processing new sales but does not revoke access from users who have already purchased. To avoid overwriting a newer version, send the delivery's current `ETag` in the `If-Match` header. Replicated deliveries are read-only; updating or archiving them returns `403` with the `replica_readonly` error code.

List delivery products GET

Returns the set of products the delivery grants access to, including the access duration of each entry and the release schedule applied to each product. `ignored_external_product_ids` is read-only. It lists the gateway product codes ignored during sales processing for the entire account, not only for this delivery, and cannot be changed through the API.