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

4.6 退款订单创建

正式环境

POST

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

/termRefundSave

pos发起退款、撤销，同商户下发起

请求参数

Body 参数application/json

reqHeader

object

系统请求头

必需

transTime

string

请求时间

必需

YYYYMMDDhhmmss

<= 14 字符

transCode

enum<string>

交易代码

必需

详见附录7.1

<= 4 字符

枚举值:

00030004

reqId

string

请求Id

必需

见附录7.5

<= 32 字符

certificateId

string

证书id

可选

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

reqBody

object

通用内容

必需

mchtCd

string

商户号

必需

商户号

<= 15 字符

orderNo

string

商户订单号

必需

订单号(仅支持数字)，一笔订单可能多次支付，对账报表体现商户订单号

<= 64 字符

reqPayType

enum<string>

请求支付方式

必需

默认值00，码值见附录7.3请求支付方式

<= 2 字符

枚举值:

000102

transAmt

string

交易金额

必需

正数且单位为【分】(100表示1元)

<= 12 字符

示例值:

以【分】为单位，100表示1元

origTransSequence

string | null

原交易流水号

可选

退货、撤销、预授权完成撤销时必填，匹配原支付交易

<= 16 字符

orderInfo

string

订单信息

可选

<= 64 字符

printInfo

string

打印信息

可选

<= 256 字符

attach

string

附加信息

可选

<= 256 字符

cashRegisterNum

string

收银机号

必需

pos默认值：lite-pos-smart-terminal

<= 64 字符

theme

string

主题

可选

用于标识此次订单的标题，POS界面展示主题

<= 120 字符

customer

string

客户

可选

用于标识此次订单的客户主体，POS界面展示客户

<= 64 字符

notifyUrl

string

通知url

可选

<= 120 字符

reqSign

string

签名

必需

详见2.3签名验签

signType

enum<string>

签名类型

必需

SM2/SM3/RSA2(默认)

枚举值:

SM2SM3RSA2

示例

{
  "reqHeader": {
    "transTime": "{% mock 'now' , '' , 'yyyyMMddHHmmss' %}",
    "certificateId": "4032069546",
    "transCode": "0004",
    "reqId": "631000000000247"
  },
  "reqBody": {
    "orderNo": "posOrder{% mock 'now' , '' , 'yyyyMMddHHmmss' %}",
    "mchtCd": "555555555555555",
    "reqPayType": "01",
    "transAmt": "1",
    "origTransSequence": "2023121900000568",
    "cashRegisterNum": "lite-pos-smart-terminal"
  },
  "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/termRefundSave' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqHeader": {
        "transTime": "{% mock '\''now'\'' , '\'''\'' , '\''yyyyMMddHHmmss'\'' %}",
        "certificateId": "4032069546",
        "transCode": "0004",
        "reqId": "631000000000247"
    },
    "reqBody": {
        "orderNo": "posOrder{% mock '\''now'\'' , '\'''\'' , '\''yyyyMMddHHmmss'\'' %}",
        "mchtCd": "555555555555555",
        "reqPayType": "01",
        "transAmt": "1",
        "origTransSequence": "2023121900000568",
        "cashRegisterNum": "lite-pos-smart-terminal"
    },
    "reqSign": "LqK1IoRNRbgHeatwutZztenvUgivxS+Z+2uUPy7cFlu5JWavndf4qJeHtSpzWMkh9eernRIdeTZWknhSA9BerqI/QuaiYCSupq+bsp8Sya7juanIRSpB1Q+ElwhNmSqNR4cIVVWLrKwwgojdLFBmIwoy4cNSVlRWm3sP+tDQ1BAjlpCfRH6oyRsPdBad8aE4Kx08PYvbWbpRCmvoVgWT9kBL05PXNR7sns6Au5AjiA0vI9KTeBa/Dqm7PkxT5Mkbek7+bABc0dT9tG0Z2lEfr3fAx6/vU2khE58OF/2x/ygWpPdAIALLdYgA1GexJgU5Ik5CoQTHWvf088hjE//OsA=="
}'

返回响应

🟢200成功

application/json

Body

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

请求流水号

可选

每笔交易请求成功后，都会生成新的流水号

singType

string | null

易生签名

可选

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

time

string | null

返回时间

可选

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

示例

{
  "rspHeader": {
    "rspCode": "000000",
    "rspInfo": "成功",
    "transCode": "0004"
  },
  "rspBody": {
    "transSequence": "2023121900000569"
  },
  "rspSign": "ilBRRTwJXvc3h7g9y9x2oSF9SfqEU0QFJVnRfAuhaYuWIUq5LaH5iLPD6CKV3io1Ylf9jOj6Cl+LbDUjW7SKBqyxhQnCN8ZCwlnCU1TAmz0+XYYm0Q8zdmOGwMnhzijFka93N7iL7jvjUOA3d5uT4H2c7DNVSmG54o4MnN/tAm4=",
  "signType": "RSA2",
  "time": "2023-12-19 17:11:27"
}

修改于 2024-04-24 01:47:58

4.5 需退款订单查询

4.7 账本查询