PayCloud SaaS

扫码支付(用户主扫)

开发中

POST

/api/cashier/entry

支付业务

最后修改时间：2024-07-29 03:36:34

责任人：王煜翔

用户打开钱包应用程序扫描代码，确认金额，并在通过安全检查后付款。

2023-10-26 新增fee_config字段
2024-07-29 新增expires字段

请求参数

Body 参数application/json

method

string

必需

固定值：cashier.pay.qrcodepay

terminal_sn

string

设备编号

必需

app_id

string

应用编号

必需

price_currency

string

标价币种

必需

order_amount

integer

订单金额

必需

tip_amount

integer

小费金额

可选

sales_tax_amount

integer

消费税金额

可选

surcharge_amount

integer

附加费金额

可选

service_charge_amount

integer

服务费金额

可选

pay_method_id

string

支付方式编号

必需

midapp_id

string

中间应用APP

可选

merchant_order_no

string

商户订单号

可选

midapp_id 不为空时存在

call_midapp_mode

string

中间调用方式

可选

midapp_id 不为空时存在

expires

integer

过期时间

可选

单位秒默认90s

longitude

string

可选

latitude

string

可选

term_ip

string

可选

os_type

string

可选

description

string

可选

fee_config

object

费用参数

可选

tip_config

object

小费配置

可选

surcharge_config

object

商户附加费配置

可选

service_charge_config

object

附加费配置

可选

sales_tax_config

object

消费税配置

可选

env_params

object

环境信息

可选

app_version

string

应用版本号

可选

os_version

string

系统版本号

可选

rom_version

string

ROM版本号

可选

sdk_version

string

SDK版本号

可选

net_link_type

string

网络环境

可选

cashier

string

收银员

可选

示例

{
    "method": "string",
    "terminal_sn": "string",
    "app_id": "string",
    "price_currency": "string",
    "order_amount": 0,
    "tip_amount": 0,
    "sales_tax_amount": 0,
    "surcharge_amount": 0,
    "service_charge_amount": 0,
    "pay_method_id": "string",
    "midapp_id": "string",
    "merchant_order_no": "string",
    "call_midapp_mode": "string",
    "expires": 0,
    "longitude": "string",
    "latitude": "string",
    "term_ip": "string",
    "os_type": "string",
    "description": "string",
    "fee_config": {
        "tip_config": {},
        "surcharge_config": {},
        "service_charge_config": {},
        "sales_tax_config": {}
    },
    "env_params": {
        "app_version": "string",
        "os_version": "string",
        "rom_version": "string",
        "sdk_version": "string",
        "net_link_type": "string"
    },
    "cashier": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/cashier/entry' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "string",
    "terminal_sn": "string",
    "app_id": "string",
    "price_currency": "string",
    "order_amount": 0,
    "tip_amount": 0,
    "sales_tax_amount": 0,
    "surcharge_amount": 0,
    "service_charge_amount": 0,
    "pay_method_id": "string",
    "midapp_id": "string",
    "merchant_order_no": "string",
    "call_midapp_mode": "string",
    "expires": 0,
    "longitude": "string",
    "latitude": "string",
    "term_ip": "string",
    "os_type": "string",
    "description": "string",
    "fee_config": {
        "tip_config": {},
        "surcharge_config": {},
        "service_charge_config": {},
        "sales_tax_config": {}
    },
    "env_params": {
        "app_version": "string",
        "os_version": "string",
        "rom_version": "string",
        "sdk_version": "string",
        "net_link_type": "string"
    },
    "cashier": "string"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

data

object

必需

trans_no

string

交易编号

必需

qrcode_url

string

支付地址

必需

psn

string

必需

示例

{
    "code": "0",
    "msg": "success",
    "data": {
        "trans_no": "dolor deserunt Excepteur",
        "qrcode_url": "http://tbpf.sy/stnw"
    },
    "psn": "220000197306166808"
}

🔴500失败

条码支付(用户被扫)

交易创建