Binance Onchain Pay enables users to buy cryptocurrency with fiat (e.g., EUR, USD) or send existing crypto from their Binance account directly to any external on-chain wallet address in a single flow—no manual withdrawal needed.
Enables partners to integrate crypto buying services:
- payment-method-list: Get available payment methods (Card, P2P, Google Pay, Apple Pay, etc.) with limits for a fiat/crypto pair
- trading-pairs: List all supported fiat currencies and cryptocurrencies
- estimated-quote: Get real-time price quote including exchange rate, fees, and estimated crypto amount
- pre-order: Create a buy order and get redirect URL to Binance payment flow
- order: Query order status and details (processing, completed, failed, etc.)
- crypto-network: Get supported blockchain networks with withdraw fees and limits
- p2p/trading-pairs: List P2P-specific trading pairs
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Binance Onchain Pay enables users to buy cryptocurrency with fiat (e.g., EUR, USD) or send existing crypto from their Binance account directly to any external on-chain wallet address in a single flow—no manual withdrawal needed.
Enables partners to integrate crypto buying services:
- payment-method-list: Get available payment methods (Card, P2P, Google Pay, Apple Pay, etc.) with limits for a fiat/crypto pair
- trading-pairs: List all supported fiat currencies and cryptocurrencies
- estimated-quote: Get real-time price quote including exchange rate, fees, and estimated crypto amount
- pre-order: Create a buy order and get redirect URL to Binance payment flow
- order: Query order status and details (processing, completed, failed, etc.)
- crypto-network: Get supported blockchain networks with withdraw fees and limits
- p2p/trading-pairs: List P2P-specific trading pairs
metadata
{"version":"0.1.1","author":"onchain-pay-team"}
license
MIT
Binance Onchain-Pay Open API Skill
Call Binance Onchain-Pay Open API endpoints with automatic RSA SHA256 request signing.
Use Cases & Scenarios
This skill is designed for the following scenarios:
1. 💳 Fiat-to-Crypto Purchase & Send
When to use: User wants to buy crypto with fiat currency and send directly to an external on-chain wallet address
Buy USDT with USD/EUR/TWD using credit card → Send to MetaMask address on BSC
Purchase BTC with Google Pay → Transfer to hardware wallet
Buy USDC with P2P → Send to DeFi protocol contract address
Blockchain network (can use default from .local.md)
contractAddress
string
No
Token contract address
address
string
Yes*
Destination wallet address for receiving crypto
* Recommended: These parameters should be provided. If not specified by user, check .local.md for defaults. If no defaults exist, ask user before proceeding.
Pre-order (buy/pre-order)
Create a buy pre-order and return the redirect link for payment.
* Either fiatAmount or (requestedAmount + amountType) should be provided. If fiatCurrency is not provided, the system will auto-select available fiat currencies.
The customization field in pre-order API accepts various flags to customize the buy flow behavior. Each merchant must have the corresponding permission configured in db.merchant_info table.
Available Customization Flags
Flag
Code
Type
Availability
Description
Use Case
LOCK_ORDER_ATTRIBUTES
1
array
Open API ✓
Lock specific order attributes so users cannot modify them. Values: 1=fiat currency, 2=crypto currency, 3=amount, 4=payment method, 5=network, 6=address, 7=fiat amount, 8=crypto amount
Fixed-parameter orders
SKIP_CASHIER
2
boolean
Open API ✓
Skip the cashier page and proceed directly to payment. Reduces user friction in the checkout flow.
Streamlined payment experience
AUTO_REDIRECTION
3
boolean
Open API ✓
Automatically redirect to redirectUrl after order completion without showing success page.
Seamless user experience
HIDE_SEND
6
boolean
Open API ✓
Hide the "Send" tab in the UI. Useful when only buy flow is needed.
Buy-only integration
SEND_PRIMARY
7
boolean
Open API ✓
Enable Send Crypto feature. If user's Binance balance is insufficient, auto-trigger buy flow first.
Send crypto to external address
MERCHANT_DISPLAY_NAME
8
string
Open API ✓
Override the display name shown to users in the UI.
Custom branding
NET_RECEIVE
9
boolean
Open API ✓
User receives net amount after deducting all fees. Total cost is more transparent.
Better UX for showing final received amount
P2P_EXPRESS
10
boolean
Open API ✓
Enable P2P Express mode for faster P2P order matching.
Quick P2P transactions
OPEN_NETWORK
11
boolean
Web3 only
Allow users to select different networks. Default is locked to pre-selected network. Note: Currently only available for Web3 entrance, not available for Open API.
Multi-network support (Web3 only)
ON_CHAIN_PROXY_MODE
12
boolean
Open API ✓
Enable Onchain-Pay Easy mode. After buying crypto, Onchain-Pay will execute smart contract interaction instead of direct withdrawal to user wallet. Requires destContractAddress, destContractABI, and destContractParams.
