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

3.1 预下单

正式环境

POST

https://phoenix.eycard.cn/sklOrder/preOrder

/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 字符

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>>

rspHeader

object

系统返回头

必需

rspCode

string

应答码

必需

00000 成功 XXXXX 其他见应答说明

rspInfo

string | null

应答消息

可选

错误信息

transCode

string | null

交易代码

可选

同请求

<= 4 字符

transSequence

string | null

交易流水

可选

同请求

<= 16 字符

easyPayCertificateId

string | null

易生证书id

可选

易生证书Id，多证书情况下需要，为空时使用默认证书

rspBody

object

必需

transSequence

string

交易流水号

必需

orderNo

string

订单号

可选

singType

string | null

易生签名

可选

可使用易生提供的公钥验签

time

string | null

返回时间

可选

交易返回的时间 YYYY-MM-dd HH:mm:ss

示例

{
  "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 查询订单列表