Alchemy Pay 💎

Hybrid payment infrastructure connecting crypto and traditional finance. Integrated with Binance Pay, Solana Pay, and 300+ payment channels worldwide.

Environment Variables

Variable	Description	Required
ALCHEMY_PAY_APP_ID	Merchant App ID	Yes
ALCHEMY_PAY_SECRET	API Secret Key	Yes
ALCHEMY_PAY_ENV	Environment: sandbox or production	No (default: sandbox)

Features

• 🔄 On-Ramp - Buy crypto with fiat (170+ countries)
• 💸 Off-Ramp - Sell crypto to fiat
• 🛒 Merchant Payments - Accept crypto payments
• 🎨 NFT Checkout - Fiat-to-NFT purchases
• 🌍 Global Coverage - Strong in Asia & LATAM

API Endpoints

Base URLs

• Sandbox: https://openapi-test.alchemypay.org
• Production: https://openapi.alchemypay.org

Create On-Ramp Order

APP_ID="${ALCHEMY_PAY_APP_ID}"
SECRET="${ALCHEMY_PAY_SECRET}"
BASE_URL="${ALCHEMY_PAY_ENV:-sandbox}"
[[ "$BASE_URL" == "production" ]] && BASE_URL="https://openapi.alchemypay.org" || BASE_URL="https://openapi-test.alchemypay.org"

TIMESTAMP=$(date +%s)
NONCE=$(openssl rand -hex 16)

# Create signature
SIGN_STRING="appId=${APP_ID}&nonce=${NONCE}&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${SIGN_STRING}${SECRET}" | sha256sum | cut -d' ' -f1)

curl -s -X POST "${BASE_URL}/open/api/v4/merchant/order/create" \
  -H "Content-Type: application/json" \
  -H "appId: ${APP_ID}" \
  -H "timestamp: ${TIMESTAMP}" \
  -H "nonce: ${NONCE}" \
  -H "sign: ${SIGNATURE}" \
  -d '{
    "crypto": "USDT",
    "network": "ETH",
    "fiat": "USD",
    "fiatAmount": "100",
    "walletAddress": "<USER_WALLET>",
    "callbackUrl": "https://your-callback.com/webhook"
  }' | jq '.'

Get Supported Cryptocurrencies

curl -s "${BASE_URL}/open/api/v4/merchant/crypto/list" \
  -H "appId: ${APP_ID}" \
  -H "timestamp: ${TIMESTAMP}" \
  -H "nonce: ${NONCE}" \
  -H "sign: ${SIGNATURE}" | jq '.data'

Get Exchange Rate

curl -s "${BASE_URL}/open/api/v4/merchant/price" \
  -H "appId: ${APP_ID}" \
  -H "timestamp: ${TIMESTAMP}" \
  -H "nonce: ${NONCE}" \
  -H "sign: ${SIGNATURE}" \
  -G --data-urlencode "crypto=BTC" \
     --data-urlencode "fiat=USD" | jq '.data'

Check Order Status

ORDER_ID="<ORDER_ID>"

curl -s "${BASE_URL}/open/api/v4/merchant/order/query" \
  -H "appId: ${APP_ID}" \
  -H "timestamp: ${TIMESTAMP}" \
  -H "nonce: ${NONCE}" \
  -H "sign: ${SIGNATURE}" \
  -G --data-urlencode "orderId=${ORDER_ID}" | jq '.'

Supported Payment Methods

Region	Methods
Global	Visa, Mastercard, Apple Pay, Google Pay
Asia	Alipay, WeChat Pay, GrabPay, GCash
LATAM	PIX, SPEI, PSE
Europe	SEPA, iDEAL, Bancontact

Supported Cryptocurrencies

• EVM: ETH, USDT, USDC, BNB, MATIC
• Solana: SOL, USDC-SPL
• Bitcoin: BTC
• Others: TRX, AVAX, ARB

Widget Integration

<!-- Embed Alchemy Pay widget -->
<iframe 
  src="https://ramp.alchemypay.org?appId=YOUR_APP_ID&crypto=ETH&network=ETH&fiat=USD"
  width="400" 
  height="600"
  frameborder="0">
</iframe>

Webhook Events

Event	Description
PAY_SUCCESS	Payment completed
PAY_FAIL	Payment failed
REFUND_SUCCESS	Refund processed

Safety Rules

1. ALWAYS verify webhook signatures
2. NEVER expose API secrets in client-side code
3. ALWAYS use HTTPS for callbacks
4. VERIFY order amounts match expected values

Error Codes

Code	Description
10001	Invalid signature
10002	Invalid parameters
10003	Order not found
20001	Insufficient balance

Links

• Alchemy Pay Docs
• Dashboard
• Status Page