提交卡密

POST

/userapi/card/submit_card

请求参数

Body 参数application/json

goods_sku

string

卡种sku，当前SKU列表：http://card.task.mf178.cn/goods/goods/index

必需

face_val

string

提交面值

必需

app_key

string

app_key

必需

timestamp

string

时间戳(秒)

必需

sign

string

签名

必需

card_no

string

卡号

必需

card_pwd

string

卡密，AES加密，加密方法请看下方

必需

face_type

integer

面值类型，0官方面值，1自定义面值，默认为0

可选

discount

integer

折扣

可选

该值范围0-1000(例子:假如折扣是0.9778，则传977.8)

callback_url

string

回调地址（如不填则使用商户后台配置的地址）外网可访问地址不要带参数

可选

attach

string

该参数在回调时原样返回

可选

third_order_id

string

业务方自己的订单号

可选

valid_day

string

卡密/卡券的有效期(天)

可选

示例

{
    "goods_sku": "SK000116",
    "face_val": "100",
    "app_key": "",
    "timestamp": "",
    "sign": "",
    "card_no": "2326999109262709659",
    "card_pwd": "841729",
    "face_type": 0,
    "discount": 900,
    "callback_url": "",
    "attach": "",
    "third_order_id": "",
    "valid_day": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://test.shop.center.mf178.cn/userapi/card/submit_card' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goods_sku": "SK000116",
    "face_val": "100",
    "app_key": "",
    "timestamp": "",
    "sign": "",
    "card_no": "2326999109262709659",
    "card_pwd": "841729",
    "face_type": 0,
    "discount": 900,
    "callback_url": "",
    "attach": "",
    "third_order_id": "",
    "valid_day": 0
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

stime

number

必需

etime

number

必需

data

object

必需

cards

array [object {3}]

提交成功卡信息

必需

error_data

array[string]

提交失败卡信息

必需

示例

{
    "code": 0,
    "message": "string",
    "stime": 0,
    "etime": 0,
    "data": {
        "cards": [
            {
                "order_id": "string",
                "card_no": "string",
                "card_pwd": "string"
            }
        ],
        "error_data": [
            "string"
        ]
    }
}

修改于 2025-04-23 06:21:53

提交卡密接口例子

订单查询