查询订单

请求参数

Query 参数

merchantNo

string

收款商户编号

必需

orderId

string

必需

商户收款请求号，原支付订单的商户订单号

Header 参数

ti-appid

string

必需

天河链开放平台商户Id

示例值:

tichain000000

ti-timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

示例值:

1647751123703

ti-signature

string

必需

API 签名：SHA256(ParamsJson+Timestamp+AppKey)

示例值:

644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api.tipay.tianhecloud.com/api/v1/yb/order/query?merchantNo=&orderId' \
--header 'ti-appid: tichain000000' \
--header 'ti-timestamp: 1647751123703' \
--header 'ti-signature: 644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b'

返回响应

🟢200成功

application/json

Body

code

integer

必需

success

boolean

必需

data

object

必需

merchantNo

string

收款商户编号

必需

orderId

string

商户订单号

必需

uniqueOrderNo

string

易宝收款订单号

必需

status

string

订单状态

必需

PROCESSING：订单待支付 SUCCESS：订单支付成功 TIME_OUT：订单已过期 FAIL:订单支付失败 CLOSE:订单关闭

orderAmount

string

订单金额

必需

单位:元示例值：12.34

payAmount

string

用户支付金额

必需

单位:元示例值：12.34

merchantFee

string

商户承担的手续费金额

必需

单位:元示例值：0.54

customerFee

string

用户手续费

必需

用户付费场景下返回.单位:元

paySuccessDate

string

支付成功时间

必需

示例值：2021-01-01 00:00:00

memo

string

对账备注

必需

商户自定义参数，会展示在交易对账单中

payWay

string

支付方式

必需

USER_SCAN：用户扫码MERCHANT_SCAN：商家扫码JS_PAY：JS支付MINI_PROGRAM：小程序支付WECHAT_OFFIACCOUNT：微信公众号支付ALIPAY_LIFE：生活号支付FACE_SCAN_PAY：刷脸支付SDK_PAY：SDK支付H5_PAY：H5支付ONEKEYPAY：一键支付BINDCARDPAY：绑卡支付E_BANK：网银支付ENTERPRISE_ACCOUNT_PAY：企业账户支付 ACCOUNT_BOOK_PAY: 记帐簿支付

token

string

支付授权token

必需

用于调用支付

fundProcessType

string

分账订单标识

必需

DELAY_SETTLE:分账 REAL_TIME:不分账

bankOrderId

string

必需

channelOrderId

string

渠道订单号

必需

该笔订单在微信、支付宝或银行侧系统生成的单号

unSplitAmount

string

剩余可分账金额

必需

剩余可分账金额;(用于分账的场景)

msg

string

必需

示例

成功示例异常示例

{
    "code": 200,
    "success": true,
    "data": {
        "merchantNo": "10088******",
        "orderId": "ON935200198000001668******",
        "uniqueOrderNo": "1013202211150000004765******",
        "status": "SUCCESS",
        "orderAmount": "19.90",
        "payAmount": "19.90",
        "merchantFee": "0.13",
        "customerFee": "0.00",
        "paySuccessDate": "2022-11-15 21:22:48",
        "memo": "******平台|专题KEY:******|购买用户:******",
        "payWay": "ONEKEYPAY",
        "token": "FD161894DE478461DD82FCF93609FDF657C38CD49F62FAC3990950ACDE8D75DB",
        "fundProcessType": "REAL_TIME",
        "bankOrderId": "2022111510000003218044740******",
        "channelOrderId": "20221115107097******"
    },
    "msg": "操作成功"
}

接口描述#

请求参数

示例代码

返回响应

接口描述