1. 8. 错误码参考
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
  1. 8. 错误码参考

9.2 错误码列表

1xxx - 系统错误#

错误码说明HTTP状态码建议处理方式
1001内部服务器错误500稍后重试
1002服务维护中503查看状态页面
1003请求超时504减少请求数据量
1004数据库错误500联系技术支持

2xxx - 认证授权错误#

错误码说明HTTP状态码建议处理方式
2001无效的AppID401检查AppID
2002签名验证失败401检查签名算法
2003时间戳过期401同步系统时间
2004重复的请求ID409使用新的请求ID
2005无权访问该商户403检查商户ID
2006IP未在白名单403配置IP白名单

3xxx - 参数错误#

错误码说明HTTP状态码建议处理方式
3001缺少必填参数400补充参数
3002参数格式错误400检查参数格式
3003参数值无效400使用有效值
3004金额过小400增加金额
3005金额过大400减少金额
3006无效的地址格式400检查地址格式

4xxx - 业务错误#

错误码说明HTTP状态码建议处理方式
4001余额不足400充值后重试
4002订单不存在404检查订单号
4003订单状态错误400检查订单状态
4004KYC未通过403完成KYC认证
4005超出限额400调整金额
4006报价已过期400重新获取报价
4007商户状态异常403联系客服

5xxx - 第三方服务错误#

错误码说明HTTP状态码建议处理方式
5001区块链网络拥堵503延后重试
5002支付渠道异常503使用备用渠道
5003银行系统维护503等待恢复
5004汇率服务不可用503稍后重试
5005KYC服务异常503联系支持
Modified at 2025-09-02 06:01:09
Previous
8.1 错误响应格式
Next
9.1 常见问题（FAQ）
Built with