3.1 认证机制
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
3.1 认证机制
Copy Page
3.1.2 签名算法
BlancBlock API使用HMAC-SHA256签名算法,AppSecret作为密钥,确保简单高效的认证机制。
Modified at
2025-09-02 05:44:02
Previous
3.1.1 认证流程
Next
3.2.1 签名原文构造