AkibaMilesGet Akiba Pass
Akiba Merchant API · REST

Vouchers that move
from campaign to checkout.

Create voucher offers, distribute unique codes to customers, redeem them in-store or online, and track every result from one merchant-focused API.

Dashboard signup is self-serve.

Choose your setup

Start in the dashboard. Integrate when you need to.

Run the full voucher workflow without code, connect it to your existing systems, or use both together.

No code

Merchant dashboard

Create voucher types, issue rewards, manage branches, and review redemptions from a self-serve dashboard.

Open merchant dashboard

Direct integration

Voucher API

Connect voucher issuance and redemption directly to your POS, checkout, CRM, or backend services.

Request API access

Flexible

Dashboard + API

Let your team manage offers in the dashboard while your systems handle distribution and redemption through the API.

See API capabilities

Merchant API

The voucher workflow, end to end.

Manage the offer in Akiba, connect distribution to the tools you already use, and make redemption simple for customers and staff.

Generate voucher codes

Create unique voucher codes with a clear description, Miles value, and expiry. Akiba returns the code immediately so your system can distribute it.

POST /api/v1/vouchers/issue

Distribute vouchers

Deliver issued codes through your existing CRM, checkout, campaign, or customer-support workflow—without moving customers into a separate tool.

POST /api/v1/vouchers/issue

Redeem at checkout

Validate and redeem a code from your POS or online checkout. Each redemption is recorded once, with a clear result your team can act on immediately.

POST /api/v1/vouchers/:code/redeem

Publish your rewards catalog

Make active rewards available to customers and keep each item's Miles cost and stock visible anywhere you embed your catalog.

GET /api/v1/catalog/:merchantSlug

Reward customer purchases

Issue Miles after a qualifying purchase and connect loyalty to the payment or order events your business already records.

POST /api/v1/rewards/issue

Track outcomes

Use signed webhooks and dashboard reporting to follow voucher issuance, redemption, customer activity, and campaign performance.

GET /api/v1/webhooksGET /api/v1/catalog/analytics

Integration basics

One partner key. Safe repeat requests.

Your integration receives a scoped API key. Idempotency keys protect voucher issuance and redemption from accidental duplicates, while signed webhooks keep your systems updated.

  • Scoped accessA partner key connected only to your merchant account.
  • Duplicate protectionIdempotency keys make retries safe at checkout.
  • Signed updatesAuthenticated webhooks for events your backend needs.
  • Clear responsesStructured JSON results and consistent error codes.
Issue a voucher
POST /api/v1/vouchers/issue
Authorization: Bearer ak_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
Idempotency-Key: issue_order_1042

{
  "description": "500 Miles off the next purchase",
  "milesValue": 500,
  "expiresAt": "2026-12-31T23:59:59Z"
}
Redeem at checkout
POST /api/v1/vouchers/AKIBA-WELCOME-10/redeem
Authorization: Bearer ak_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
Idempotency-Key: redeem_order_1179

{
  "redeemedBy": "customer_123"
}

Built for merchant operations

Easy for your systems. Easy for your staff.

Targeted distribution

Issue a welcome, win-back, or spend-based voucher from the customer and campaign tools you already use.

In-store redemption

Validate a code at the counter, connect it to a branch and order, and give staff a clear success or failure result.

Online checkout

Apply Akiba vouchers inside your existing checkout and record redemption without sending customers through another flow.

Get started

Start with your first voucher.

Create your merchant account and manage vouchers immediately from the dashboard. When you're ready to connect distribution or redemption to your own systems, request a partner API key.

Dashboard signup is self-serve. We respond to API access requests within 2 business days.