Transak 🚀

Web3 payment infrastructure. Fiat on/off-ramp trusted by 600+ DeFi, NFT, and wallet projects.

Environment Variables

Variable	Description	Required
TRANSAK_API_KEY	API Key	Yes
TRANSAK_SECRET	Secret for webhooks	No
TRANSAK_ENV	STAGING or PRODUCTION	No

Features

• 🌍 170+ Countries - Global coverage
• 💳 100+ Payment Methods - Cards, bank, mobile
• ⛓️ 75+ Blockchains - EVM, Solana, Bitcoin, etc.
• 🔄 Off-Ramp - Sell crypto to fiat
• 🎨 NFT Checkout - Direct NFT purchases
• 🔌 Widget SDK - Easy integration

API Base URLs

• Staging: https://api-stg.transak.com
• Production: https://api.transak.com

Get Supported Cryptocurrencies

API_KEY="${TRANSAK_API_KEY}"
ENV="${TRANSAK_ENV:-STAGING}"
[[ "$ENV" == "PRODUCTION" ]] && BASE_URL="https://api.transak.com" || BASE_URL="https://api-stg.transak.com"

curl -s "${BASE_URL}/api/v2/currencies/crypto-currencies" | jq '.response[:10] | .[] | {symbol: .symbol, name: .name, network: .network.name}'

Get Supported Fiat Currencies

curl -s "${BASE_URL}/api/v2/currencies/fiat-currencies" | jq '.response[:10] | .[] | {symbol: .symbol, name: .name, paymentOptions: .paymentOptions}'

Get Price Quote

FIAT="USD"
CRYPTO="ETH"
FIAT_AMOUNT="100"
NETWORK="ethereum"
PAYMENT_METHOD="credit_debit_card"

curl -s "${BASE_URL}/api/v2/currencies/price" \
  -G \
  --data-urlencode "fiatCurrency=${FIAT}" \
  --data-urlencode "cryptoCurrency=${CRYPTO}" \
  --data-urlencode "fiatAmount=${FIAT_AMOUNT}" \
  --data-urlencode "network=${NETWORK}" \
  --data-urlencode "paymentMethod=${PAYMENT_METHOD}" \
  --data-urlencode "isBuyOrSell=BUY" | jq '{
    cryptoAmount: .response.cryptoAmount,
    fiatAmount: .response.fiatAmount,
    totalFee: .response.totalFee,
    conversionPrice: .response.conversionPrice
  }'

Generate Widget URL

API_KEY="${TRANSAK_API_KEY}"
WALLET_ADDRESS="<USER_WALLET>"
CRYPTO="ETH"
NETWORK="ethereum"
FIAT_AMOUNT="100"
FIAT_CURRENCY="USD"

# Build widget URL
WIDGET_URL="https://global.transak.com/?apiKey=${API_KEY}"
WIDGET_URL+="&walletAddress=${WALLET_ADDRESS}"
WIDGET_URL+="&cryptoCurrencyCode=${CRYPTO}"
WIDGET_URL+="&network=${NETWORK}"
WIDGET_URL+="&fiatAmount=${FIAT_AMOUNT}"
WIDGET_URL+="&fiatCurrency=${FIAT_CURRENCY}"
WIDGET_URL+="&productsAvailed=BUY"

echo "Widget URL: $WIDGET_URL"

Get Order Status

ORDER_ID="<ORDER_ID>"

curl -s "${BASE_URL}/api/v2/partners/order/${ORDER_ID}" \
  -H "api-key: ${API_KEY}" | jq '{
    status: .response.status,
    cryptoAmount: .response.cryptoAmount,
    transactionHash: .response.transactionHash,
    walletAddress: .response.walletAddress
  }'

Supported Networks

Network	ID	Tokens
Ethereum	ethereum	ETH, USDT, USDC, DAI
Polygon	polygon	MATIC, USDT, USDC
Arbitrum	arbitrum	ETH, ARB, USDC
Optimism	optimism	ETH, OP, USDC
BSC	bsc	BNB, BUSD, USDT
Solana	solana	SOL, USDC
Avalanche	avaxcchain	AVAX, USDC
Base	base	ETH, USDC
Bitcoin	bitcoin	BTC

Payment Methods

Method	Regions	Speed
Credit/Debit Card	Global	Instant
Apple Pay	Global	Instant
Google Pay	Global	Instant
Bank Transfer	Global	1-3 days
SEPA	Europe	1-2 days
PIX	Brazil	Instant
UPI	India	Instant
GCash	Philippines	Instant
GrabPay	SEA	Instant

Order Status Codes

Status	Description
AWAITING_PAYMENT_FROM_USER	Waiting for payment
PAYMENT_DONE_MARKED_BY_USER	Payment submitted
PROCESSING	Processing order
PENDING_DELIVERY_FROM_TRANSAK	Sending crypto
COMPLETED	Order completed
CANCELLED	Order cancelled
FAILED	Order failed
REFUNDED	Payment refunded
EXPIRED	Order expired

Webhook Events

# Webhook payload
{
  "eventID": "ORDER_COMPLETED",
  "webhookData": {
    "id": "order-123",
    "status": "COMPLETED",
    "cryptoAmount": 0.05,
    "cryptoCurrency": "ETH",
    "transactionHash": "0x...",
    "walletAddress": "0x..."
  }
}

Verify Webhook

verify_webhook() {
  local payload="$1"
  local signature="$2"
  
  local expected=$(echo -n "$payload" | openssl dgst -sha256 -hmac "$TRANSAK_SECRET" | cut -d' ' -f2)
  
  [[ "$signature" == "$expected" ]]
}

Widget Customization

# Additional widget parameters
WIDGET_URL+="&themeColor=0066FF"           # Custom color
WIDGET_URL+="&hideMenu=true"               # Hide menu
WIDGET_URL+="&disableWalletAddressForm=true"  # Lock wallet
WIDGET_URL+="&exchangeScreenTitle=Buy%20Crypto"  # Custom title
WIDGET_URL+="&defaultPaymentMethod=credit_debit_card"

Safety Rules

1. VERIFY webhook signatures
2. NEVER expose API keys client-side
3. CHECK order status before fulfilling
4. VALIDATE wallet addresses

Error Handling

Error	Cause	Solution
INVALID_API_KEY	Bad API key	Check credentials
UNSUPPORTED_CRYPTO	Currency unavailable	Check supported list
AMOUNT_TOO_LOW	Below minimum	Increase amount
AMOUNT_TOO_HIGH	Above maximum	Decrease amount

Links

• Transak Docs
• Dashboard
• Widget Demo