Welcome to Thiqwave API

Thiqwave is stablecoin settlement infrastructure for fintechs and institutions: a settlement control plane that collects, holds, screens, converts, and settles across fiat and stablecoin rails through a single API.

Quick Start

Get started with Thiqwave in 6 steps:

1. Register your partner account and get your API key
2. Create a customer — the business or individual you're collecting from
3. Create a beneficiary — the payout destination for that customer
4. Request a quote — get a live FX rate locked for ~2 minutes
5. Accept the quote — lock the rate
6. Create a transaction — initiate collection and settlement

# 1. Create a customer
curl -X POST https://api.thiqwave.com/api/v1/customers \
  -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. Create a beneficiary (the payout destination)
curl -X POST https://api.thiqwave.com/api/v1/beneficiaries \
  -H "X-API-Key: your-test-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "<customer_id>",
    "type": "business",
    "full_name": "Singapore Exports Pte Ltd",
    "country": "SG",
    "account": {
      "kind": "BANK_ACCOUNT",
      "destination_asset": "SGD",
      "iban": "SG00BANK0000000001",
      "bank_country": "SG",
      "is_default": true
    }
  }'

# 3. Request a quote
curl -X POST https://api.thiqwave.com/api/v1/transactions/quote \
  -H "X-API-Key: your-test-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "corridor_id": "AE-SG",
    "source_asset": "AED",
    "source_amount_minor": "1000000",
    "destination_asset": "SGD",
    "destination_kind": "BANK",
    "customer_id": "<customer_id>"
  }'

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

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

Core Features

Fiat Collections (UAE)

Collect funds via virtual named IBAN — the payer sends a wire to the assigned IBAN; Thiqwave confirms receipt and advances the payment automatically.

Stablecoin Settlement

Convert collected fiat to USDT or USDC and send to a wallet on a supported network, with the transaction hash returned for verification.

Fiat Cross-Border Payout

Off-ramp stablecoins to fiat bank accounts in supported corridors.

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

Quotes & Transactions

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

Customers & Applications

Method	Endpoint	Description
POST	/api/v1/customers	Create customer
GET	/api/v1/customers	List customers
GET	/api/v1/customers/:id	Get customer
POST	/api/v1/beneficiaries	Create beneficiary
GET	/api/v1/beneficiaries	List beneficiaries
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

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 (instant)	No
LIVE	true (production)	Real collection rails	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	Settlement initiated
settlement.completed	Settlement completed
settlement.failed	Settlement failed
customer.kyb_approved	KYB check passed
customer.kyb_rejected	KYB check failed

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

Support

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