测试环境商家账户是用来进行支付业务体验的账号，交易中产生的一切信息均为生产环境数据，由于体验业务特点，不会产生清算资金划拔，所以使用测试商家账号时请务必使用小额支付（建议：小于0.1元）。

3.1 预下单

正式环境

https://phoenix.eycard.cn/sklOrder

POST

/preOrder

POST

请求参数

Body 参数application/json

reqHeader

object

系统请求头

必需

通用请求头

transTime

string

请求时间

必需

YYYYMMDDhhmmss

transCode

enum<string>

交易代码

必需

详见附录5.1

<= 4 字符

枚举值:

000100030004

transSequence

string | null

交易流水号

可选

<= 40 字符

reqId

string

机构Id

必需

certificateId

string

证书id

可选

请求方证书Id，多证书情况下需要

reqBody

object (OrderPayQuery)

通用内容

必需

通用请求内容

searchNo

string | null

搜索号

可选

搜索号

<= 64 字符

transSequence

string | null

交易流水号

可选

，查询时transSequence，或者mchtCd+OrderNo二选一必填

<= 16 字符

transCode

string | null

交易代码

可选

搜索号searchNo长度必须小于64

<= 16 字符

orderNo

string | null

订单号

可选

, 查询时transSequence，或者mchtCd+OrderNo二选一必填

<= 64 字符

正则匹配:

^[A-Za-z0-9]*$

mchtCd

string | null

商户号

可选

，查询时transSequence，或者mchtCd+OrderNo二选一必填

reqPayType

string | null

请求支付类型

可选

请求支付类型

<= 2 字符

transAmt

string | null

交易金额

可选

交易金额

<= 12 字符

正则匹配:

^[0-9]*$

printInfo

string | null

打印信息

可选

打印信息

<= 256 字符

orderInfo

string | null

订单信息

可选

订单信息

<= 256 字符

attach

string | null

附件信息

可选

附件信息

<= 256 字符

instDate

string | null

交易日期

可选

交易日期

<= 8 字符

termId

string | null

终端号

可选

终端号

<= 8 字符

origTransSequence

string | null

原交易流水号

可选

原交易流水号

<= 16 字符

refNo

string | null

交易参考号或者原支付订单号

可选

参考号，

<= 12 字符

origTransCode

string | null

可选

原交易代码,反向交易不为空

<= 16 字符

origInstDate

string | null

原交易日期

可选

<= 8 字符

outRefNo

string | null

条码订单号

可选

<= 32 字符

transState

string | null

交易状态

可选

>= 1 字符<= 1 字符

notifyUrl

string | null

通知URL

可选

<= 120 字符

goodsInfoList

array[object (GoodsDetailBeanOrderInsert) {9}]

必需

reqSign

string

签名

必需

详见2.3签名验签

signType

string | null

签名方式

可选

RSA，SM2，SM3 默认不填写RSA2

示例

{
    "reqHeader": {
        "transTime": "{% mock 'now' , '' , 'yyyyMMddHHmmss' %}",
        "transCode": "0001",
        "reqId": "631000000000247"
    },
    "reqBody": {
        "orderNo": "{% mock 'now' , '' , 'yyyyMMddHHmmss' %}",
        "termId": "77777771",
        "mchtCd": "555555555555555",
        "reqPayType": "01",
        "printInfo": "printInfo...",
        "orderInfo": "orderInfo...",
        "transAmt": "100",
        "attach": "Attach......",
        "origTransSequence": "",
        "notifyUrl": "https://mtest.eycard.cn/misNotify/misPayStateNotify"
    },
    "reqSign": "LqK1IoRNRbgHeatwutZztenvUgivxS+Z+2uUPy7cFlu5JWavndf4qJeHtSpzWMkh9eernRIdeTZWknhSA9BerqI/QuaiYCSupq+bsp8Sya7juanIRSpB1Q+ElwhNmSqNR4cIVVWLrKwwgojdLFBmIwoy4cNSVlRWm3sP+tDQ1BAjlpCfRH6oyRsPdBad8aE4Kx08PYvbWbpRCmvoVgWT9kBL05PXNR7sns6Au5AjiA0vI9KTeBa/Dqm7PkxT5Mkbek7+bABc0dT9tG0Z2lEfr3fAx6/vU2khE58OF/2x/ygWpPdAIALLdYgA1GexJgU5Ik5CoQTHWvf088hjE//OsA=="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://phoenix.eycard.cn/sklOrder/preOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqHeader": {
        "transTime": "{% mock '\''now'\'' , '\'''\'' , '\''yyyyMMddHHmmss'\'' %}",
        "transCode": "0001",
        "reqId": "631000000000247"
    },
    "reqBody": {
        "orderNo": "{% mock '\''now'\'' , '\'''\'' , '\''yyyyMMddHHmmss'\'' %}",
        "termId": "77777771",
        "mchtCd": "555555555555555",
        "reqPayType": "01",
        "printInfo": "printInfo...",
        "orderInfo": "orderInfo...",
        "transAmt": "100",
        "attach": "Attach......",
        "origTransSequence": "",
        "notifyUrl": "https://mtest.eycard.cn/misNotify/misPayStateNotify"
    },
    "reqSign": "LqK1IoRNRbgHeatwutZztenvUgivxS+Z+2uUPy7cFlu5JWavndf4qJeHtSpzWMkh9eernRIdeTZWknhSA9BerqI/QuaiYCSupq+bsp8Sya7juanIRSpB1Q+ElwhNmSqNR4cIVVWLrKwwgojdLFBmIwoy4cNSVlRWm3sP+tDQ1BAjlpCfRH6oyRsPdBad8aE4Kx08PYvbWbpRCmvoVgWT9kBL05PXNR7sns6Au5AjiA0vI9KTeBa/Dqm7PkxT5Mkbek7+bABc0dT9tG0Z2lEfr3fAx6/vU2khE58OF/2x/ygWpPdAIALLdYgA1GexJgU5Ik5CoQTHWvf088hjE//OsA=="
}'

返回响应

🟢200成功

application/json

Body

reactor.core.publisher.Mono<com.easypay.tianlu.posp.vo.ApiRsp<com.easypay.tianlu.posp.order.facade.dto.OrderPayOutput>>

rspBody

object

必需

transSequence

string

必需

orderNo

string

必需

orderInfo

string

必需

rspHeader

object

必需

easyPayCertificateId

string

必需

rspCode

string

必需

rspInfo

string

必需

transCode

string

必需

rspSign

string

必需

示例

成功示例成功示例

{"rspBody":{"transSequence":"2024031300002193","orderNo":"20240313150944"},"rspHeader":{"easyPayCertificateId":"00000000","rspCode":"000000","rspInfo":"成功","transCode":"0001"},"rspSign":"nRbjtxmeIaeZxX2sU6JVwtlJ7bniAIGyA9p2+AAHuNSGeLIv1n9izduSDwRJUAMy/gJDpRCuFtNznQoXGJJFpShhWqkog9h0+0+Mvdr/Z2WHDPt2f/WNohHrhLyxjWbfgUohqqK3F/+RBH9PePhtQ6B5LV79eLT/s4hu46RUz3ET3AnQgeeI0m2IkmLgP0XXER/Td5LbCwxBIo5W6jmmRtl+3gM5mgdSjl22xOmFxXG9OEBULTO+gAPsGX7UEpS5xJLQRMpzLppNDZzOKWT2EkXRriURMM0e019nZfXFx2XsOdl7wwRSlF4Pw+QZWAvrnLpFDj3O8Dkiym1NoD1GwQ=="}

修改于 2024-12-31 01:33:56

2.6 生成商户公私钥

3.2 查询订单列表