4. 业务指南
Copy Page
BlancBlock OpenAPI
1. 平台介绍
1.1 关于BlancBlock
1.2 核心能力
1.3 支持的业务场景
2. 快速开始
2.1 对接流程
2.2 获取API凭证
3. 技术对接指南
3.1 认证机制
3.1.1 认证流程
3.1.2 签名算法
3.2 签名生成
3.2.1 签名原文构造
3.3 请求规范
3.3.1 请求Header
3.3.2 请求频率限制
4. 业务指南
4.1 商户入驻流程
4.2 账户体系说明
4.3 收款人管理
4.4 支付工具管理
4.5 报价与下单
4.6 订单处理流程
购买加密货币(BUY_CRYPTO)
卖出加密货币(SELL_CRYPTO)
加密货币充值(DEPOSIT_CRYPTO)
加密货币提现(WITHDRAW_CRYPTO)
法币充值(DEPOSIT_FIAT)
法币提现(WITHDRAW_FIAT)
平台内部兑换(FIAT_TO_CRYPTO / CRYPTO_TO_FIAT)
5. API接口列表
5.1 商户管理
Create Merchant
Query Merchant List
Get Merchant Details
Update Merchant
Register Merchant
Get Merchant KYC URL
Get Merchant KYC Detail
5.2 账户管理
Query Account List
Page Query Merchant Addresses
5.3 收款工具管理
Query Collection Instruments
5.4 收款人管理
Add Payee
Update Payee
Delete Payee
Query Payees
5.5 交易管理
Deposit Fiat
Get quote for depositing fiat
Create deposit fiat order
Withdraw Fiat
Get quote for withdrawing fiat
Create withdraw fiat order
Deposit Crypto
Get quote for depositing crypto
Create deposit crypto order
Withdraw Crypto
Get quote for withdrawing crypto
Create withdraw crypto order
Buy Crypto
Get quote for buying crypto
Create buy crypto order
Sell Crypto
Get quote for selling crypto
Create sell crypto order
Fiat to Crypto
Get quote for fiat to crypto conversion
Create fiat to crypto order
Crypto to Fiat
Get quote for crypto to fiat conversion
Create crypto to fiat order
Return Inbound
Create return inbound order
Wallet Debit
Create wallet debit order
Wallet Credit
Create wallet credit order
Get Quote
Create Order
Create Batch Orders
Query Orders
Query Order Details
5.6 系统功能
Query Exchange Rates
Query Supported Assets
Health Check
File Upload
Query Exchange Rates V2
6. Webhook事件通知
6.1 Webhook订阅
Configure Webhook
Webhook Event Endpoint
6.2 Webhook事件
事件类型
Query Webhook Events
6.3 Webhook安全
6.3.1 签名验证
6.3.2 安全建议
6.4 重试机制
6.4.1 重试策略
6.4.2 重试条件
7. 数据字典
KYC类型 (KYC Type)
商户状态 (Merchant Status)
认证状态 (KYC Status)
订单类型 (Order Type)
订单状态 (Order Status)
支付方式 (Payment Method)
资产类型 (AssetType)
网络代码 (NetworkCode)
锁定金额类型 (AmountType)
支付工具类型 (InstrumentType)
银行账户类型 (BankAccountType)
费用承担方 (FeeBearer)
8. 错误码参考
8.1 错误响应格式
9.2 错误码列表
9. 附录
9.1 常见问题(FAQ)
9.2 HMAC-SHA256签名示例
9.3 技术支持
Schemas
Schemas
CryptoAddressDetails
BankAccountDetails
FiatWalletCode
RateRequest
OrderListItem
WalletDebitApplyOrderRequest
ReturnInboundOrderRequest
DepositFiatQuoteRequest
WalletDebitOrderRequest
QueryOrdersResponse
WalletDebitSuccessOrderRequest
DepositFiatOrderRequest
WalletCreditOrderRequest
WalletDebitReturnOrderRequest
WithdrawFiatQuoteRequest
BatchCreateOrderRequest
MerchantStatus
BatchCreateOrderItem
WithdrawFiatOrderRequest
KycStatus
DepositCryptoQuoteRequest
AssetCode
DepositCryptoOrderRequest
NetworkCode
WithdrawCryptoQuoteRequest
OrderType
WithdrawCryptoOrderRequest
OrderStatus
BuyCryptoQuoteRequest
ActivationStatus
BuyCryptoOrderRequest
SellCryptoQuoteRequest
WebhookEventType
SellCryptoOrderRequest
FiatToCryptoQuoteRequest
FiatToCryptoOrderRequest
CreateMerchantRequest
CryptoToFiatQuoteRequest
CryptoToFiatOrderRequest
KycApplication
CompanyInfo
KycDocuments
DocumentFile
FundingInfo
BeneficialOwner
PersonalInfo
Identification
ResidenceInfo
OwnershipInfo
Director
SubmissionInfo
CreateMerchantResponse
QueryMerchantsResponse
MerchantSummary
MerchantDetailsResponse
UpdateMerchantRequest
QueryAccountsResponse
AccountInfo
PayeeType
AddPayeeRequest
UpdatePayeeRequest
UpdatePayeeResponse
AddPayeeResponse
QueryPayeesResponse
PayeeInfo
QuoteRequest
QuoteResponse
CreateOrderRequest
CreateOrderResponse
OrderDetailsResponse
PayoutSummary
FeeItem
QueryAssetsResponse
AssetInfo
NetworkInfo
ConfigureWebhookRequest
WebhookConfig
ConfigureWebhookResponse
QueryWebhookEventsResponse
WebhookEventBase
WebhookOrderEventData
WebhookPayeeEventData
WebhookKycEventData
WebhookOrderEventPayload
WebhookPayeeEventPayload
WebhookKycEventPayload
WebhookEventPayload
ListDataBase
HealthResponse
RateItem
QueryRatesResponse
Amount
SourceEndpoint
PayeeRef
InternalDestination
DestinationEndpoint
PaymentInstrument
BankAccountDetails
CryptoAddressDetails
InternalAccountDetails
PaymentOptions
CollectionInstrumentsResponse
CollectionInstrumentSelect
UploadFileResponse
UploadFileResultResponse
Response
NotFound
Conflict
SlippageExceeded
AddressQueryRequest
MerchantRegisterRequest
AddressInfo
MerchantRegisterData
MerchantType
QueryAddressesResponse
QueryAddressesInfo
MerchantRegisterResponse
MerchantKycUrlRequest
MerchantKycUrlData
MerchantKycUrlResponse
ChannelKycDetailRequest
ChannelKycDetailReview
ChannelKycDetailData
ChannelKycDetailResponse
ChannelKycDetailReviewResult
ChannelKycDetailRiskLabels
ChannelKycDetailAddress
ChannelKycDetailNfcInfo
ChannelKycDetailIdDoc
AccountStatus
ChannelKycDetailBeneficiaryInfo
ChannelKycDetailBeneficiary
ChannelKycDetailCompanyInfo
ChannelKycDetailInfo
StandardResponse
ChannelKycDetailFixedInfo
ChannelKycDetailAgreementItem
ErrorResponse
ChannelKycDetailAgreement
ChannelKycDetailField
ChannelKycDetailCustomField
ChannelKycDetailIndividual
MerchantProfile
ChannelKycDetailCompany
ChannelKycDetailCompanyDocsGroupDefinition
ChannelKycDetailCompanyBeneficiaryDefinition
ChannelKycDetailKybSettings
ChannelKycDetailDocSet
ChannelKycDetailRequiredIdDocs
ChannelKycDetailQuestionItem
ChannelKycDetailSection
ChannelKycDetailQuestionnaire
ChannelKycDetailNote
ChannelKycDetailMemberOf
PaginationInfo
PageDataBase
4. 业务指南
Copy Page
4.4 支付工具管理
支付工具概述
#
支付工具是平台用于收款的工具,分为两大类:
银行账户
: 用于法币的收付款
加密地址
: 用于数字资产的收付款
银行账户
#
主账户 (MASTER)
平台的主要银行账户
用于大额交易和机构客户
支持多种清算方式
虚拟子账户 (VIRTUAL)
为商户分配的专用虚拟账户
便于资金识别和管理
支持本地清算,到账更快
加密地址
#
地址分配
为每个商户在每个网络分配独立充值地址
支持ERC-20、TRC-20等主流网络
地址一经分配长期有效
网络支持
ERC-20
: 以太坊网络,确认时间13-15分钟
TRC-20
: 波场网络,确认时间3-5分钟
#
Modified at
2025-09-24 10:18:12
Previous
4.3 收款人管理
Next
4.5 报价与下单