Wasabi Card API

Overview

The Wasabi Card API is a RESTful backend that wraps the Wasabi Card Open API platform. As a third-party developer you interact only with this API — you never call Wasabi directly.

Base URL

# Live (Production)
https://wasabi.alphalinx.top

# Sandbox
https://wasabi.alphalinx.top/sandbox

Authentication

Every request to /api/v1/* must include your API key in the X-API-KEY request header.

# Example — all requests require this header
X-API-KEY: wc_YourSecretKeyHere
Content-Type: application/json

Getting a Key

API keys are issued by the platform administrator via the admin portal. Each key is tied to your developer account. Contact the admin to receive yours.

Missing or Invalid Key

{
  "success": false,
  "code":    401,
  "msg":     "Invalid or missing API key.",
  "data":    null
}

Request Format

All requests use JSON bodies with Content-Type: application/json. Unless otherwise stated, endpoints use the POST method.

cURL Example

curl -X POST https://wasabi.alphalinx.top/sandbox/api/v1/cardholders/occupations \
  -H "X-API-KEY: wc_YourSecretKeyHere" \
  -H "Content-Type: application/json"

Request with Body

curl -X POST https://wasabi.alphalinx.top/sandbox/api/v1/cards/balance \
  -H "X-API-KEY: wc_YourSecretKeyHere" \
  -H "Content-Type: application/json" \
  -d '{
    "cardNo": "4111111111111111"
  }'

Response Format

Every response — success or error — uses the same JSON envelope:

{
  "success": true,      // boolean — true only when code=200
  "code":    200,       // integer status code
  "msg":     "Success",  // human-readable message
  "data":    { ... }    // payload — object, array, or null
}

Always check success === true (or code === 200) before processing data.

Successful List Response Example

{
  "success": true,
  "code":    200,
  "msg":     "Success",
  "data": {
    "total":   42,
    "records": [ ... ]
  }
}

Error Codes

Validation Error Example

{
  "success": false,
  "code":    422,
  "msg":     "Validation failed.",
  "data": {
    "email": [ "The email field must be a valid email address." ],
    "cardHolderModel": [ "The selected card holder model is invalid." ]
  }
}

Rate Limiting

Each API key is limited to 60 requests per minute. Exceeding this returns HTTP 429. Implement exponential back-off in your client.

# Retry strategy (example)
attempt 1: immediate
attempt 2: wait 1s
attempt 3: wait 2s
attempt 4: wait 4s

Common — Reference Data

Lookup tables required for other API calls. Cache these responses — they rarely change.

Wallet

On-chain deposit orders and wallet transaction history.

Cards

Full card lifecycle: create, manage, fund, and query transaction history.

Cardholders

KYC onboarding and cardholder lifecycle. Cardholder creation is async — the initial response returns wait_audit and the final result arrives via webhook.

B2B vs B2C Model

Accounts

Merchant wallet accounts — balances, ledger history, and fund transfers between accounts.

Work Orders

Submit and track platform work orders (e.g. card activation requests).

Webhooks — Overview

Several operations are asynchronous: the API returns an immediate pending status, and the final result is delivered later via webhook. Your server must poll the Webhook Events API to retrieve these results.

Async Operations (always poll for final result)

Webhook Event Reference

Cardholder Status Values

Polling Webhook Events

Use GET /api/v1/webhook-events to retrieve stored async results. Filter by category and reference_id for the specific operation you're waiting on.

Example: Poll for cardholder creation result

# Step 1 — create cardholder, get holderId from response
curl -X POST https://wasabi.alphalinx.top/sandbox/api/v1/cardholders/create-v2 \
  -H "X-API-KEY: wc_..." -d '{ "cardHolderModel": "B2C", ... }'
# Response: { "data": { "holderId": 124024, "status": "wait_audit" } }

# Step 2 — poll until status is pass_audit or reject
curl "https://wasabi.alphalinx.top/sandbox/api/v1/webhook-events?category=card_holder&reference_id=124024" \
  -H "X-API-KEY: wc_..."

Query Parameters

Sample Response

{
  "success": true,
  "code": 200,
  "data": {
    "total": 1,
    "data": [
      {
        "id": 5,
        "category":          "card_holder",
        "reference_id":     "124024",
        "merchant_order_no": "ORDER20250101000001",
        "status":           "pass_audit",
        "payload": {          // full raw payload from Wasabi
          "holderId":    124024,
          "status":      "pass_audit",
          "description": "Approved"
        },
        "created_at": "2026-04-18T10:30:00.000000Z"
      }
    ]
  }
}