收银台订单预创建

POST

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

请求参数

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

store_id

number

门店编码

可选

return_url

string

可选

完成支付后返回的商户网页跳转地址使用h5收银台接入时支付成功返回地址

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

必需

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

payment

number

可选

支付方式 1支付宝 2微信 (APP接入时必填 h5收银台非必填)

total_amount

string

支付金额单位元

必需

client_ip

string

用户侧支付IP地址

必需

subject

string

订单备注或商品信息

可选

extra_common_param

string

可选

回传参数异步通知返回

timeout_express

number

可选

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

is_divistion

number

可选

是否分账 0不分账 1分账不传默认0

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/app_pay' \
--data-urlencode 'store_id=' \
--data-urlencode 'return_url=' \
--data-urlencode 'notify_url=' \
--data-urlencode 'notify_format=' \
--data-urlencode 'party_order_number=' \
--data-urlencode 'payment=' \
--data-urlencode 'total_amount=' \
--data-urlencode 'client_ip=' \
--data-urlencode 'subject=' \
--data-urlencode 'extra_common_param=' \
--data-urlencode 'timeout_express=' \
--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

返回数据

必需

order_no

string

系统预支付订单号

必需

可用于发起APP、微信小程序、支付宝小程序、各种URL收银台等支付

applet_url

string

小程序收银台

必需

使用场景
商户可生成二维码，支持用户使用微信或支付宝，扫码后进入支付页面完成支付，适用于网页、PC应用、电子设备、预付款打印小票等顾客后扫码支付场景

web_url

string

H5收银台

必需

使用场景
⑴：商户可生成二维码，支持用户使用微信、支付宝、云闪付，扫码后进入支付页面完成支付，适用于网页、PC应用、电子设备、预付款打印小票等顾客后扫码支付场景
⑵：可用于代替自有H5应用在微信、支付宝、云闪付侧需要支付的场景收银台，开发者只需关注业务层开发，无需关注收银台开发提高效率

示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_no": "2023112512006010180145704864",
    "applet_url": "https://api.kfim.cn/apipay/2023112512006010180145704864",
    "web_url": "https://www.kfim.cn/webpay/pages/web/pay?orderno=2023112512006010180145704864"
  }
}

🟠404失败

H5收银台接入支付说明

支付结果通知