分账请求 - 支付中台接口文档

请求参数

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

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

可选

商户订单号二选一，注意：只支持20天内的分账交易订单发起分账请求

order_no

string

可选

系统订单号二选一，注意：只支持20天内的分账交易订单发起分账请求

is_divistion

number

必需

订单是否分账 1分账 2不分账

division_mode

number

可选

分账模式 1按比例 2按金额订单不分账时可以不传

div_list

string

可选

分账明细订单不分账时可以不传分账明细每次最多分10个商户 json字符格式

div_list[][merchant_code]

string

分账商户号

可选

div_list[][div_ratio]

string

可选

分账比例：按比例分账时分账明细中分账比例之和必须为1

div_list[][div_amount]

string

可选

分账金额：按金额分账时分账明细中分账金额之和必须等于订单金额

div_list[][is_chargeFee]

string

可选

是否承担手续费 01 是 02否手续费必须是分账明细其中一个商户承担

business_code

string

业务code

必需

mch_num

string

商户号

必需

timestamp

string

当前时间戳10位

必需

sign

string

签名

必需

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.kfim.cn/pay_gate/divistion' \
--data-urlencode 'notify_url=' \
--data-urlencode 'notify_format=' \
--data-urlencode 'party_order_number=' \
--data-urlencode 'order_no=' \
--data-urlencode 'is_divistion=' \
--data-urlencode 'division_mode=' \
--data-urlencode 'div_list=' \
--data-urlencode 'div_list[][merchant_code]=' \
--data-urlencode 'div_list[][div_ratio]=' \
--data-urlencode 'div_list[][div_amount]=' \
--data-urlencode 'div_list[][is_chargeFee]=' \
--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

系统订单号

必需

product

string

产品类型

必需

APP、JSAPI、BARCODE

status

integer

订单状态

必需

0 未支付 1已支付 2支付失败

payment

integer

支付方式

必需

1支付宝 2微信 3云闪付 4刷卡

create_time

string

下单时间

必需

格式：2023-11-24 18:19:08

amount

string

订单金额

必需

单位元

refund_amount

string

退款金额

必需

单位元

total_amount

string

实收金额

必需

单位元

pay_time

string

支付时间

必需

未支付或支付失败为空；格式：2023-11-24 18:19:34

refund_status

integer

退款状态

必需

0未退款 1部分退款 2全部退款

fee

string

订单手续费

必需

单位元

refund_fee

string

退款手续费

必需

单位元

total_fee

string

实收

必需

单位元

notes

string

订单备注

必需

party_order_number

string

商户订单号

必需

示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_no": "2023112412006010181908738545",
    "product": "APP",
    "status": 1,
    "payment": 2,
    "create_time": "2023-11-24 18:19:08",
    "amount": "10.00",
    "refund_amount": "10.00",
    "total_amount": "0.00",
    "pay_time": "2023-11-24 18:19:34",
    "refund_status": 2,
    "fee": "0.04",
    "refund_fee": "0.04",
    "total_fee": "0.00",
    "notes": "测试订单",
    "party_order_number": "202311241819243194"
  }
}

🟠404失败