反扫支付

POST

https://api.kfim.cn/pay_gate/barcodePay

请求参数

Body 参数application/x-www-form-urlencoded

store_id

number

门店编码

可选

cashier_id

string

收银员编码

可选

notify_url

string

异步通知地址

可选

notify_format

string

可选

回调请求数据格式 form 、json
默认值为form 请根据实际情况填写
form 即Content-Type为application/x-www-form-urlencoded ，
json 即 Content-Type为application/json)

party_order_number

string

必需

发起交易侧系统商户订单号

total_amount

string

支付金额单位元

必需

auth_code

string

必需

扫码支付授权码(APP中的付款码)，设备读取用户展示的条码或者二维码信息 (目前支持微信、支付宝、云闪付)

device_sn

string

可选

终端设备SN编码，云闪付反扫时必填

client_ip

string

用户侧支付IP地址

必需

subject

string

订单备注或商品信息

可选

extra_common_param

string

可选

回传参数异步通知返回

timeout_express

number

可选

交易过期时间单位分钟默认 15分钟

示例值:

is_divistion

number

可选

（分账商户专属）是否分账 0不分账 1分账不传默认走系统预设分账，如果传1分账必须在交易日20天内调分账请求接口，否则按不分账处理，结算至交易商户

extra_json_data

string

可选

自有ERP信息扩展，格式要求：JSON字符串，最大长度为100个字符;例：{"type":"order","source":"online"}

business_code

string

业务code

必需

mch_num

string

商户号

必需

timestamp

string

当前时间戳10位

必需

sign

string

签名

必需

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kfim.cn/pay_gate/barcodePay' \
--data-urlencode 'store_id=' \
--data-urlencode 'cashier_id=' \
--data-urlencode 'notify_url=' \
--data-urlencode 'notify_format=' \
--data-urlencode 'party_order_number=' \
--data-urlencode 'total_amount=' \
--data-urlencode 'auth_code=' \
--data-urlencode 'device_sn=' \
--data-urlencode 'client_ip=' \
--data-urlencode 'subject=' \
--data-urlencode 'extra_common_param=' \
--data-urlencode 'timeout_express=15' \
--data-urlencode 'is_divistion=' \
--data-urlencode 'extra_json_data=' \
--data-urlencode 'business_code=' \
--data-urlencode 'mch_num=' \
--data-urlencode 'timestamp=' \
--data-urlencode 'sign='

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0 成功其它失败

msg

string

描述

必需

返回描述信息

data

object

返回数据

必需

out_trade_no

string

系统订单号

必需

out_transaction_id

string

支付渠道订单号

必需

total

number

交易金额

必需

payType

integer

支付授权码所属平台

必需

1支付宝 2微信 3云闪付

status

integer

交易状态

必需

1交易成功 2交易失败 3 交易等待此时以订单查询结果或异步通知结果为准

payTime

string

发起交易时间

必需

格式：2022-06-01 10:18:31

示例

{
	"code": 0,
	"msg": "success",
	"data": {
		"out_trade_no": "2024030115004121161830721384",
		"out_transaction_id":"20240527Nf0000000006002950048130",
		"total": 0.02,
		"payType": 1,
		"status": 1,
		"payTime": "2022-06-01 10:18:31"
	}
}

🟠404失败

反扫支付说明

移动APP接入支付说明