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

指令结算查询

正式环境

https://phoenix.eycard.cn/sklOrder

POST

/settle/settleQuery

根据dfStatus(代付状态)判断是否成功
取值：DF_SUCCESS：代付成功；DF_PROCESSING：代付处理中

请求参数

Body 参数application/json

reqHeader

object (ReqHeader)

通用请求头

必需

transTime

string

必需

请求时间 N14 Y YYYYMMDDhhmmss

transCode

string

可选

交易代码 N6 N 业务交易码，应答原样返回

transSequence

string

可选

交易流水 ANS6…40 N 请求流水号，应答原样返回

reqId

string

必需

请求Id ANS32 Y 商户号、机构号等

certificateId

string

可选

证书id ANS6…40 N 证书Id，多证书情况下需要

easyPayCertificateId

string

可选

易生证书id ANS6…40 N 易生证书Id，多证书情况下需要，为空时使用默认证书

signType

string

签名类型

可选

reqSign

string

请求签名

必需

reqBody

object (SettleQuery)

请求内容实体

必需

merCode

string

商户号

必需

<= 15 字符

orderSettleNo

string

指令结算批次号

必需

<= 39 字符

instDate

string

交易日期

必需

正则匹配:

\d{8}

示例

{
    "reqHeader": {
        "transTime": "{% mock 'now' , '' , 'yyyyMMddHHmmss' %}",
        "transCode": "0001",
        "reqId": "DEV20240124154037"
    },
    "reqBody": {
        "merCode": "831290472980729",
        "orderSettleNo": "20250530085108",
        "instDate": "{% mock 'now' , '' , 'yyyyMMdd' %}"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://phoenix.eycard.cn/sklOrder/settle/settleQuery' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqHeader": {
        "transTime": "{% mock '\''now'\'' , '\'''\'' , '\''yyyyMMddHHmmss'\'' %}",
        "transCode": "0001",
        "reqId": "DEV20240124154037"
    },
    "reqBody": {
        "merCode": "831290472980729",
        "orderSettleNo": "20250530085108",
        "instDate": "{% mock '\''now'\'' , '\'''\'' , '\''yyyyMMdd'\'' %}"
    }
}'

返回响应

🟢200成功

application/json

Body

rspHeader

object

必需

rspCode

string

必需

rspInfo

string

必需

transCode

string

必需

easyPayCertificateId

string

必需

rspBody

object

必需

merCode

string

必需

orderSettleNo

string

必需

instDate

string

必需

settleResult

array[object (SettleResultOutput) {32}]

必需

time

string

必需

示例

成功示例成功示例

{
  "rspHeader": {
    "rspCode": "",
    "rspInfo": "",
    "transCode": "",
    "transSequence": "",
    "easyPayCertificateId": ""
  },
  "rspBody": {},
  "rspSign": "",
  "signType": "",
  "time": ""
}

指令结算请求