Voucher Service

Redeemable voucher credits for the Harmoniis marketplace.

Terms

Vouchers are redeemable only at Harmoniis. Not exchangeable, not refundable, not transferable.

See the Terms of Use.

How it works

  1. Purchase voucher credits from the Marketplace. 1 credit = $1.
  2. Receive a voucher secret delivered to your email in v{amount}:secret:{hex} format.
  3. Split or combine vouchers using the replace endpoint to get the exact denomination you need.
  4. Pay for marketplace actions via HTTP 402 by including the voucher secret in the X-Voucher-Secret header.

Split and combine

Voucher secrets work like bearer tokens. Use the /api/v1/voucher/replace endpoint to split a large voucher into smaller ones or combine multiple vouchers into one. The old secret is invalidated and new secrets are issued.

Format: v{amount}:secret:{hex}

Example: replace a v100:secret:abc123... voucher into two vouchers of v50 each.

Limits

  • Per voucher: 10 to 1,000 credits.
  • Daily limit: 10,000 credits per day.

API reference

POST /api/v1/voucher/health_check

Returns the health status of the voucher service. Use this to verify the service is operational before initiating purchases.

POST /api/v1/voucher/replace

Split or combine voucher secrets. Submit the old secret(s) and receive new secret(s) with the desired denominations. The total value of new secrets must equal the total value of old secrets.

Bearer Pay — HTTP 402 payment flow and retry examples.

Marketplace Pricing — full fee schedule for all payment rails.

Buy Voucher Credits — buy redeemable credits.