alchemy-pay

Alchemy Pay (ACH) fiat-to-crypto payment gateway integration. On-ramp, off-ramp, merchant payments, and NFT checkout services.

Quality

64%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./public/skills/0xterrybit/alchemy-pay/SKILL.md

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

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

Error Codes

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