Welcome to Thiqwave API

Thiqwave is a B2B2B non-custodial payment infrastructure API for the MENA region. It enables businesses to accept payments in SAR/AED via Open Banking and settle cross-border in stablecoins (USDT/USDC) or fiat — in a single API call.

Quick Start

ℹ️ The canonical, verified walkthrough is the Quickstart (Flow B). The snippets below are a legacy summary kept for context; follow the Quickstart for production integrations.

Get started with Thiqwave in 5 steps:

1. Register your partner account and get your API key
2. Create a participant — the business or individual you're collecting from
3. Request a quote — get a live FX rate locked for 2 minutes
4. Accept the quote — lock the rate
5. Create a payment — initiate collection and settlement

# 1. Create a participant
curl -X POST https://api.thiqwave.com/api/v1/participants \
  -H "X-API-Key: your-test-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "BUSINESS",
    "legal_name": "Al Noor Trading LLC",
    "email": "finance@alnoor.ae",
    "country": "AE",
    "country_name": "United Arab Emirates",
    "tax_id": "TRN100123456"
  }'

# 2. Request a quote
curl "https://api.thiqwave.com/api/v1/quotes" \
  -H "X-API-Key: your-test-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "from_counterparty_id": "<counterparty_id>",
    "to": { "type": "WALLET", "currency": "USDT", "address": "0xAbC..." },
    "source_amount": "10000.00",
    "source_currency": "AED"
  }'

# 3. Accept the quote
curl -X POST "https://api.thiqwave.com/api/v1/quotes/<quote_id>/accept" \
  -H "X-API-Key: your-test-api-key"

# 4. Create the payment
curl -X POST "https://api.thiqwave.com/api/v1/payments" \
  -H "X-API-Key: your-test-api-key" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "quote_id": "<quote_id>", "collection_method": "LEAN_OPEN_BANKING" }'

Core Features

Open Banking Collection (UAE & Saudi Arabia)

Collect AED via Aani and SAR via Sarie using Lean Technologies. Partners receive a payment URL to redirect their payer to bank authentication — no card data, instant settlement confirmation.

Stablecoin Settlement

Convert collected fiat to USDT or USDC and send to any EVM-compatible wallet address, with the transaction hash returned for verification.

Fiat Cross-Border Payout

Off-ramp stablecoins to fiat bank accounts in India, Pakistan, Philippines, and other corridors (Phase 3).

Compliance Built In

Every payment runs automated KYB, sanctions screening, and wallet KYT checks. Results are recorded in an immutable audit trail. Your TEST API key uses mock providers — zero real checks, instant approvals.

Webhooks

Subscribe to real-time events delivered with HMAC-SHA256 signatures. Retry with exponential backoff if your endpoint is unavailable.

API Endpoints

For the full per-endpoint reference, see API Reference.

Quotes & Payments (transaction-service — port 3002)

Method	Endpoint	Description
GET	/api/v1/quotes	Request a live FX quote
POST	/api/v1/quotes/:id/accept	Lock the rate
POST	/api/v1/payments	Initiate collection + settlement
GET	/api/v1/payments/:id	Poll payment status
GET	/api/v1/payments	List payments (cursor pagination)
GET	/api/v1/logs	API request logs

Partners & Applications (partner-service — port 3000)

Method	Endpoint	Description
POST	/api/v1/participants	Create participant
GET	/api/v1/participants	List participants
GET	/api/v1/participants/:id	Get participant
POST	/api/v1/webhooks	Register webhook endpoint
GET	/api/v1/webhooks	List webhook endpoints
PATCH	/api/v1/webhooks/:id	Update webhook
DELETE	/api/v1/webhooks/:id	Delete webhook
POST	/api/v1/webhooks/:id/secret/rotate	Rotate signing secret
POST	/api/v1/applications	Create application
GET	/api/v1/applications	List applications
POST	/api/v1/applications/:id/keys	Generate API key

Note: /api/v1/participants was previously named /api/v1/counterparties. The old path is still served as a deprecated alias and will be removed in a future release — migrate to /api/v1/participants.

Environments

Thiqwave uses a two-level environment model:

Your API key type	Infrastructure LIVE_MODE	Collection provider	Money moves?
TEST	Any	Mock (instant, no-op)	No
LIVE	false (dev/staging)	Mock (Lean sandbox)	No
LIVE	true (production)	Lean (real Open Banking)	Yes

Your TEST API key is safe to use in any environment — it never touches real banking rails.

Webhooks

Subscribe to events to track payment progress in real-time:

Event	When
settlement.created	Payment initiated
settlement.completed	Payment settled
settlement.failed	Payment failed
counterparty.kyb_approved	KYB check passed (Phase 2)
counterparty.kyb_rejected	KYB check failed (Phase 2)

See Authentication for API key management and Environments for TEST vs LIVE setup.

Support

• Email: support@thiqwave.com
• Status: status.thiqwave.com