Keyless fulfilment

Hosted redemption links instead of raw keys — issue, revoke, regenerate, and the order.activated signal when the buyer redeems.

Keyless delivery is generally available. Instead of returning raw game keys to your store backend, Avrix issues a hosted redemption URL (provider hosted_redemption): the key never passes through your systems, so it cannot leak from them. Platform entitlement providers (Steam gift, Epic, GOG) are not available yet; asking for one answers 422 before any key is pulled.

Keyless redemption flow#

Diagram

A keyless line can carry up to 20 keys. With quantity > 1 the response's delivery.redemptionUrl is one link for all of them: the buyer opens it and reveals each key on its own. delivery.items lists every key with its own fulfillmentId (for revoke and regenerate), keyId and link. With quantity: 1, items holds the single key.

Availability#

GateRequirement
PlatformGET /api/seller/v1/whoami → capabilities.keylessEnabled (on by default)
Content OwnerGET /allocations → keyless.allowed (default true)
Providerhosted_redemption
Quantity1 to 20 per line

deliveryMode: "keyless" on a SKU whose Content Owner does not allow it returns 403 FEATURE_DISABLED with details.reason: "KEYLESS_NOT_ALLOWED_BY_PUBLISHER". Send deliveryMode: "auto" to follow the Content Owner instead: keyless when keyless.default is true, keys otherwise. Sandbox SKU SANDBOX-KEYLESS-001 delivers keyless.

Revoking before redemption#

A link that has not been redeemed can be revoked:

Each revocation sends fulfillment.revoked with the fulfillmentId, keyId, linkGroupId and a reason (manual, refund, chargeback or revoked_key). A revoked key shows as cancelled on the hosted page. Redeemed links cannot be revoked.

Create a keyless order#

curl -s -X POST "https://api.avrix.io/api/seller/v1/orders" \
  -H "Authorization: Bearer $AVRIX_API_KEY" \
  -H "Idempotency-Key: keyless-store-10432" \
  -H "Content-Type: application/json" \
  -d '{
  "skuCode": "SANDBOX-KEYLESS-001",
  "quantity": 1,
  "orderReference": "keyless-store-10432",
  "expectedUnitPriceCents": 5999,
  "countryCode": "NL",
  "deliveryMode": "keyless",
  "integrationOrderContext": {
    "schemaVersion": 1,
    "salesCountryCode": "NL",
    "currencyCode": "EUR",
    "salesPriceGrossMinor": 7999,
    "priceIncludesTax": true,
    "salesTaxRatePercent": 21,
    "salesChannel": "web",
    "salesTaxAmountMinor": 1388,
    "paymentProcessorReference": "pay_keyless_1",
    "checkoutSessionId": "cs_keyless_1",
    "consumerIp": "198.51.100.42"
  }
}'

Successful response:

JSON
{
  "data": {
    "type": "fulfilled",
    "deliveryMode": "keyless",
    "pulled": 1,
    "orderReference": "store-order-10432",
    "delivery": {
      "provider": "hosted_redemption",
      "redemptionUrl": "https://app.avrix.io/redeem/v1/...",
      "fulfillmentId": "kf_4c81...",
      "expiresAt": "2026-09-04T09:14:22.108Z"
    }
  }
}

Persist fulfillmentId and deliver redemptionUrl to the buyer. No key material passes through your systems.

Requires scope seller:orders:manage.

OperationPathEffect
RevokePOST /api/seller/v1/orders/fulfillments/{fulfillmentId}/revokeInvalidates the link. Idempotent when already terminal (revoked, redeemed, or activated). Does not return keys to inventory.
RegeneratePOST /api/seller/v1/orders/fulfillments/{fulfillmentId}/regenerateRevokes the old link and issues a new fulfillmentId + URL. Keeps the original expiry. Not allowed after buyer activation (409 ALREADY_ACTIVATED) or expiry (409 EXPIRED).

Buyer-facing expired copy#

When a buyer opens an expired hosted redemption link, they see:

This redemption link has expired.

Other terminal messages include revoked and already-used variants on the hosted page.

Hosted redemption defaults (platform-issued):

SettingDefault
Max views1 (one-time reveal)
Expiry30 days from issue (expiresAt on the delivery object)

redemption.expiring gives advance notice inside the 24-hour window before expiresAt. redemption.expired fires once when expiresAt has passed without activation. If a link is lost, rotate it before activation and before its original expiry. Rotation does not extend its lifetime.

Webhooks#

EventWhen
order.fulfilledInventory committed; includes delivery object (no keys)
order.activatedBuyer revealed code or platform activation completed
redemption.expiringAn unredeemed hosted link enters the 24h window before expiresAt
redemption.expiredThe hosted link has passed expiresAt without activation

Security#

  • Redemption tokens are cryptographically signed; the platform stores hash only
  • Reveal is one-time (default max views 1) with expiry (default 30 days)
  • Decrypt + audit occurs at reveal time, not at order time

What links here

Published guides that link to this page.

Search docs

Search documentation…