TiPay

交易下单

POST

https://api.tipay.tianhecloud.com/api/v1/yb/order/create

接口描述

商户需先调用该接口生成预支付订单

使用说明

数藏交易只支持钱包支付，商户需传入指定参数来唤醒钱包支付方式，如下：
钱包支付：walletMemberNo为必传，钱包会员标识通过钱包注册/登录接口来获取

请求参数

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

Body 参数application/json

merchantNo

string

商户编号

必需

商户编号收款商户商编。单笔收款必传，合单收款场景中请在子单域信息subOrderDetail里提供

orderId

string

商户收款请求号

必需

商户收款请求号。可包含字母、数字、下划线；需保证在商户端不重复。合单收款场景中，此参数为合单收款请求号

orderAmount

string

订单金额

必需

订单金额。单位为元，精确到小数点后两位

notifyUrl

string

接收支付结果的通知地址

必需

接收支付结果的通知地址,

walletMemberNo

string

钱包会员标识

必需

钱包会员标识,传入该参数将唤醒钱包支付

goodsName

string

商品名称

必需

商品名称简单描述订单信息或商品简介，用于展示在收银台页面或者支付明细中。单笔收款必传，合单收款场景中请在子单域信息subOrderDetail里提供(*当商品名称超过85个字符时，易宝会默认保留前85个字符)

fundProcessType

string

分账标识

可选

分账标识。不传，默认不分账。传入 DELAY_SETTLE 标识该订单需要进行分账

memo

string

对账备注

可选

对账备注。商户自定义参数，会展示在交易对账单中,支持85个字符（中文或者英文字母）

expiredTime

string

订单过期时间

可选

订单过期时间，格式为yyyy-MM-dd HH:mm:ss，为空时默认在请求下单120分钟后失效，最长支持30天

redirectUrl

string

支付成功后跳转的URL

可选

redirectUrl 支付成功后跳转的URL，如商户指定页面回调地址，支付完成后会从易宝的支付成功页跳转至商家指定页面，只有走标准收银台的订单此地址才有作用。注意：最大长度200个字符。

csUrl

string

清算回调地址

可选

清算回调地址清算成功服务器回调地址，不传则不通知

businessInfo

string

自定义参数信息

可选

自定义参数信息

示例

{
    "merchantNo": "esse cupidatat tempor dolore in",
    "orderId": "22",
    "orderAmount": "7",
    "notifyUrl": "http://jnhybgnyam.pf/tqgdv",
    "walletMemberNo":"wallet member no",
    "businessInfo": "reprehenderit aute sit in laboris",
    "csUrl": "http://ugv.aw/jdjqc",
    "fundProcessType": "ut eu",
    "subOrderDetail": "pariatur fugiat elit",
    "payerInfo": "{\"bankCardNo\":\"6225750005831234\",\"cardName\":\"爱丽丝\",\"idCardNo\":\"130225199006093323\",\"mobilePhoneNo\":\"13902092131\",\"userID\":\"20056788\"}",
    "redirectUrl": "http://fouexrvep.uy/sdboljc",
    "payMerchantNo": "dolore dolor aliquip",
    "memo": "adipisicing mollit",
    "ypPromotionInfo": "[{\"type\":\"CUSTOM_ALLOWANCE\"}]",
    "goodsName": "做张各",
    "terminalInfo": "{\"terminalNo\":\"15704925\",\"terminalType\":\"POS\"}",
    "expiredTime": "2011-03-10 15:11:25"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tipay.tianhecloud.com/api/v1/yb/order/create' \
--header 'ti-appid: tichain000000' \
--header 'ti-timestamp: 1647751123703' \
--header 'ti-signature: 644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantNo": "esse cupidatat tempor dolore in",
    "orderId": "22",
    "orderAmount": "7",
    "notifyUrl": "http://jnhybgnyam.pf/tqgdv",
    "walletMemberNo":"wallet member no",
    "businessInfo": "reprehenderit aute sit in laboris",
    "csUrl": "http://ugv.aw/jdjqc",
    "fundProcessType": "ut eu",
    "subOrderDetail": "pariatur fugiat elit",
    "payerInfo": "{\"bankCardNo\":\"6225750005831234\",\"cardName\":\"爱丽丝\",\"idCardNo\":\"130225199006093323\",\"mobilePhoneNo\":\"13902092131\",\"userID\":\"20056788\"}",
    "redirectUrl": "http://fouexrvep.uy/sdboljc",
    "payMerchantNo": "dolore dolor aliquip",
    "memo": "adipisicing mollit",
    "ypPromotionInfo": "[{\"type\":\"CUSTOM_ALLOWANCE\"}]",
    "goodsName": "做张各",
    "terminalInfo": "{\"terminalNo\":\"15704925\",\"terminalType\":\"POS\"}",
    "expiredTime": "2011-03-10 15:11:25"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

success

boolean

成功标识

必需

data

object

数据

必需

merchantNo

string

商户编号

必需

orderId

string

商户收款请求号

必需

uniqueOrderNo

string

易宝收款订单号

必需

token

string

token

必需

orderAmount

number

订单金额

必需

单位：元

payUrl

string

支付地址

必需

msg

string

消息

必需

示例

成功示例异常示例

{
    "code": 200,
    "success": true,
    "data": {
        "bizSystemNo": "",
        "merchantNo": "",
        "orderId": "",
        "uniqueOrderNo": "",
        "token": "",
        "orderAmount": -1,
        "payUrl": ""
    },
    "msg": "操作成功"
}

🟢200支付结果通知

易宝钱包支付页面交互步骤图解

查询订单

交易下单

接口描述#

使用说明#

请求参数

示例代码

返回响应

接口描述

使用说明