交易下单

请求参数

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

自定义参数信息

可选

自定义参数信息

directPayType

string

支付方式

可选

使用易宝一键支付需传入：YJZF

userNo

string

用户标识

可选

使用易宝一键支付需传入：用户标识，用户在商户的唯一标识。作用：首次支付成功再支付时传相同的用户标识可实现快捷绑卡支付

payerInfo

string

付款信息

可选

使用易宝一键支付需传入，json格式,用于上送卡信息，并展示在收银台（下单成功不可修改，cardName:姓名、 bankCardNo:卡号、idCardNo:身份证号、mobilePhoneNo:手机号、userID:会员编号），示例值：{"cardName":"爱丽丝","idCardNo":"130225199006093323"}

示例

{
    "merchantNo": "esse cupidatat tempor dolore in",
    "orderId": "22",
    "orderAmount": "7",
    "notifyUrl": "http://jnhybgnyam.pf/tqgdv",
    "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

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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",
    "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支付结果通知

接口描述

使用说明

请求参数

示例代码

返回响应

交易下单

接口描述#

使用说明#

请求参数

示例代码

返回响应

接口描述

使用说明