PayCloud SaaS

交易创建

开发中

POST

/api/cashier/entry

Qs Cashier

最后修改时间：2024-07-19 03:09:11

责任人：王煜翔

交易创建

请求参数

Authorization

在 header 添加参数

x-auth-token

示例：

x-auth-token: ********************

Body 参数application/json

method

string

请求Method

必需

固定值qscashier.pay.bankcard.trans.create

app_id

string

应用号

必需

version

string

版本号

必需

固定值: 2.0

timestamp

integer

时间戳

必需

sign

string

签名

必需

terminal_sn

string

设备编号

必需

price_currency

string

标价币种

必需

order_amount

number

订单金额

必需

trans_type

enum<integer>

交易类型

必需

1: Purchase2: Purchase cancellation3: Refund4: Pre-auth5: Pre-auth Cancellation6: Pre-auth Completion7: Pre-auth Completion Cancellation8: Pre-auth Completion Refund11: Cashback12: CashWithdraw

枚举值:

1234567811

pay_method_id

string

交易方式

必需

当trans_type = 1，4，11，12 时存在

pay_channel_id

string

支付通道

必需

card_data_encrypt

string

加密卡信息

可选

orig_trans_no

string

原交易号

可选

当trans_type = 2，3，5，6，7，8 时 orig_trans_no 或orig_merchant_order_no 存在一个即可，同时存在以orig_trans_no为准

orig_merchant_order_no

string

原商户交易号

可选

当trans_type = 2，3，5，6，7，8 时 orig_trans_no 或orig_merchant_order_no 存在一个即可，同时存在以orig_trans_no为准

cashback_amount

number

返现金额

可选

tip_amount

number

小费金额

可选

merchant_order_no

string

商户订单号

可选

ref_no

string

参考号

可选

voucher_no

string

凭证号

可选

batch_no

string

批次号

可选

auth_no

string

授权号

可选

sys_no

string

系统跟踪号

可选

description

string

交易描述

可选

env_params

object

环境信息

可选

bankcard_ext_params

object

银行卡扩展参数

可选

示例

{
    "method": "string",
    "app_id": "string",
    "version": "string",
    "timestamp": 0,
    "sign": "string",
    "terminal_sn": "string",
    "price_currency": "string",
    "order_amount": 0,
    "trans_type": 1,
    "pay_method_id": "string",
    "pay_channel_id": "string",
    "card_data_encrypt": "string",
    "orig_trans_no": "string",
    "orig_merchant_order_no": "string",
    "cashback_amount": 0,
    "tip_amount": 0,
    "merchant_order_no": "string",
    "ref_no": "string",
    "voucher_no": "string",
    "batch_no": "string",
    "auth_no": "string",
    "sys_no": "string",
    "description": "string",
    "env_params": {},
    "bankcard_ext_params": {}
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/cashier/entry' \
--header 'Content-Type: application/json' \
--header 'x-auth-token;' \
--data-raw '{
    "method": "string",
    "app_id": "string",
    "version": "string",
    "timestamp": 0,
    "sign": "string",
    "terminal_sn": "string",
    "price_currency": "string",
    "order_amount": 0,
    "trans_type": 1,
    "pay_method_id": "string",
    "pay_channel_id": "string",
    "card_data_encrypt": "string",
    "orig_trans_no": "string",
    "orig_merchant_order_no": "string",
    "cashback_amount": 0,
    "tip_amount": 0,
    "merchant_order_no": "string",
    "ref_no": "string",
    "voucher_no": "string",
    "batch_no": "string",
    "auth_no": "string",
    "sys_no": "string",
    "description": "string",
    "env_params": {},
    "bankcard_ext_params": {}
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

data

object

必需

trans_no

string

交易编号

必需

sys_no

string

系统追踪号

可选

voucher_no

string

凭证号

可选

psn

string

必需

示例

{
    "code": "string",
    "msg": "string",
    "data": {
        "trans_no": "string",
        "sys_no": "string",
        "voucher_no": "string"
    },
    "psn": "string"
}

🔴500失败

银行卡通道签到

交易完成