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#
Quantity and links#
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#
| Gate | Requirement |
|---|---|
| Platform | GET /api/seller/v1/whoami → capabilities.keylessEnabled (on by default) |
| Content Owner | GET /allocations → keyless.allowed (default true) |
| Provider | hosted_redemption |
| Quantity | 1 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:
- by you — POST /orders/fulfillments/{fulfillmentId}/revoke (for example a fraud review);
- by a refund or chargeback on POST /refunds for its key;
- when the Content Owner revokes the key.
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:
{
"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.
Manage links — revoke and regenerate#
Requires scope seller:orders:manage.
| Operation | Path | Effect |
|---|---|---|
| Revoke | POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/revoke | Invalidates the link. Idempotent when already terminal (revoked, redeemed, or activated). Does not return keys to inventory. |
| Regenerate | POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/regenerate | Revokes 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.
Link TTL and views#
Hosted redemption defaults (platform-issued):
| Setting | Default |
|---|---|
| Max views | 1 (one-time reveal) |
| Expiry | 30 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#
| Event | When |
|---|---|
order.fulfilled | Inventory committed; includes delivery object (no keys) |
order.activated | Buyer revealed code or platform activation completed |
redemption.expiring | An unredeemed hosted link enters the 24h window before expiresAt |
redemption.expired | The 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