1. 5.5 交易管理
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
        POST
      • Create Order
        POST
      • Create Batch Orders
        POST
      • Query Orders
        GET
      • Query Order Details
        GET
    • 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. 5.5 交易管理

Query Order Details

GET
/api/v1/orders/{orderId}
Get detailed information about a specific order

Request

Authorization
API Key
Add parameter in header
x-signature
Example:
x-signature: ********************
or
Path Params

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/orders/?merchantId=undefined' \
--header 'x-app-id;' \
--header 'x-timestamp: 0' \
--header 'x-nonce;' \
--header 'x-request-id;' \
--header 'x-lang;' \
--header 'x-signature: <api-key>'

Responses

🟢200OK
application/json
Order details retrieved successfully
Bodyapplication/json

Example
{
    "success": true,
    "requestId": "string",
    "timestamp": "2019-08-24T14:15:22.123Z",
    "data": {
        "orderId": "string",
        "merchantId": "string",
        "partnerOrderId": "string",
        "orderType": "DEPOSIT_FIAT",
        "status": "CREATED",
        "source": {
            "type": "INTERNAL_ACCOUNT",
            "details": {
                "currency": "USDT",
                "accountId": "string"
            }
        },
        "destination": {
            "payeeId": "string"
        },
        "collectionInstrument": {
            "merchantId": "string",
            "type": "BANK_ACCOUNT",
            "bankAccountType": "MASTER",
            "label": "string",
            "details": {
                "countryCode": "string",
                "currency": "USDT",
                "accountName": "string",
                "accountNo": "string",
                "iban": "string",
                "beneficiaryAddress": "string",
                "beneficiaryBankName": "string",
                "beneficiaryBankCode": "string",
                "beneficiaryBankAddress": "string",
                "intermediaryBankName": "string",
                "intermediaryBankCode": "string",
                "intermediaryBankAddress": "string",
                "routingNumber": "string",
                "sortCode": "string",
                "supportedCurrencies": [
                    "USDT"
                ],
                "referenceCode": "string"
            }
        },
        "payoutSummary": {
            "payoutMethod": "BANK_TRANSFER",
            "estimatedArrival": "string",
            "rails": "string",
            "senderBankName": "string",
            "senderBankCode": "string",
            "senderCountryCode": "string",
            "transferReference": "string",
            "mt103Ref": "string",
            "achTraceNo": "string",
            "proofOfPaymentUrl": "http://example.com",
            "asset": "USDT",
            "networkCode": "ERC20",
            "txHash": "string",
            "fromAddress": "string",
            "explorerUrl": "http://example.com"
        },
        "fromAmount": {
            "value": "string",
            "currency": "USDT"
        },
        "toAmount": {
            "value": "string",
            "currency": "USDT"
        },
        "exchangeRate": "string",
        "fees": [
            {
                "type": "string",
                "name": "string",
                "desc": "string",
                "amount": {
                    "value": "string",
                    "currency": "USDT"
                }
            }
        ],
        "paymentOptions": {
            "feeBearer": "OUR",
            "purpose": "string",
            "remittanceNote": "string",
            "onBehalf": {
                "entityName": "string"
            },
            "custom": {
                "property1": "string",
                "property2": "string"
            },
            "poboType": "string"
        },
        "transactionHash": "string",
        "confirmations": 0,
        "estimatedTime": "string",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z",
        "completedAt": "2019-08-24T14:15:22.123Z",
        "failureReason": {
            "code": "string",
            "message": "string"
        }
    }
}
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠429Too Many Requests
Modified at 2025-10-16 02:21:00
Previous
Query Orders
Next
Query Exchange Rates
Built with