alchemy-pay

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

Quality

57%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./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