上报订单结果

POST

/api/card/order_deal

订单状态说明：

code	说明
0	处理成功
400	传参错误
500	其他原因处理失败

remark关键词字段处理逻辑说明：

关键词	处理结果	逻辑归类
面值不符（我绑卡了，按实际面值结算）	异常	异常场景
面值不符（我没绑，我不要这个卡）	异常	异常场景
卡号/卡密错误	处理失败	卡密原因
未激活	处理失败	卡密原因
卡已被使用/失效	处理失败	卡密原因
其它原因(请务必补充描述)	异常	异常场景

请求参数

Body 参数application/json

app_key

string

【公共参数】系统分配给商户的秘钥

必需

sign

string

【公共参数】签名

必需

所有请求参数签名

timestamp

string

【公共参数】Unix时间戳

必需

时区为 GMT+8 允许与服务器最大误差30秒

zx_id

string

直销批次ID

必需

zx_id,order_id至少传一个

order_id

string

订单ID

必需

zx_id,order_id至少传一个

deal_type

integer

处理类型（1处理成功2处理失败）

必需

remark

string

备注原因（处理失败时必填）关键词[卡已被使用/失效]

可选

具体词库详细见文档上方说明

voucher

string

失败凭证图片url（处理失败时必填）

可选

示例

示例示例1

{
    "app_key":"750746803",
    "sign":"a3387fa6ead5db4b",
    "timestamp":"1684317365",
    "zx_id":"1012582",
    "order_id":"24010911001246",
    "deal_type":2,
    "remark":"卡已被使用",
    "voucher":"https://public-1251005695.cos.ap-guangzhou.myqcloud.com/uploads/image/merchant/items/202401/9f968c7174901b68946f3fd1cc1497ac.jpeg",
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

示例示例1

curl --location --request POST 'http://test.merchant.center.mf178.cn/api/card/order_deal' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_key":"750746803",
    "sign":"a3387fa6ead5db4b",
    "timestamp":"1684317365",
    "zx_id":"1012582",
    "order_id":"24010911001246",
    "deal_type":2,
    "remark":"卡已被使用",
    "voucher":"https://public-1251005695.cos.ap-guangzhou.myqcloud.com/uploads/image/merchant/items/202401/9f968c7174901b68946f3fd1cc1497ac.jpeg",
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

stime

number

必需

etime

number

必需

data

array[string]

必需

示例

成功示例成功示例

{
    "code": 0,
    "message": "操作成功",
    "stime": 1745378086.021302,
    "etime": 1745378088.174408,
    "data": []
}

修改于 2025-04-23 03:15:41

订单查询API

订单状态回调API

上报订单结果

订单状态说明：#

remark关键词字段处理逻辑说明：#

请求参数

示例代码

返回响应

订单状态说明：

remark关键词字段处理逻辑说明：