商户创建将默认创建商户默认应用&门店等信息，如不想配置在默认应用可自行去新建

发起商户进件

● 到商户管理页下发起商户进件

发起进件页面说明

进入到渠道进件信息页面，按提示填写对应资料

按需填写商户入驻费率信息（此为运营端示例，代理/商户请自行尝试，费率展示效果不同），单笔及银联阶梯说明不再赘述

资料填写完成确认无误后，点击发起进件

等待渠道侧审核/进行签约（不同渠道规则不同，以下以渠道侧进件较为方便的方式进行说明）

● 如为一直为审核中，可检查发起进件填写的手机/邮箱是否有短信/邮件通知需要进行签约，若没有则可进行等待或咨询三方支付公司
● 用户手机签约完毕后，进件列表状态变更为<进件成功>

注意：关键配置请注意检查，影响支付配置及实际下单！！！

● 此时若进件发起时勾选了自动配置到应用，那么商户应用参数已自动配置完成。无需操作！！！
● 若未勾选自动配置，则需手动进行配置参数！！！
○ 手动配置参数请点击进击列表中操作-更多-参数配置-选择应用-一键配置-微信参数配置以及后续打开该应用支付配置

打开<签约开通>页面此时需入网用户法人主体手机扫码（电子协议签约/微信/支付宝实名认证）过程，完成此步骤后方可进行支付

商户入驻完成，支付测试

● 辅助终端报备（以渠道实际情况为准，文档要求则配置）
○ 使用场景说明，如渠道侧要求支付必须含有终端报备信息，则此流程必须操作，以用于支付时上送渠道报备成功后的设备信息
○ 为什么要终端报备？三方支付公司应《259号文》要求
○ 地图信息不显示？请先在<系统设置>中配置高德地图参数
○ 列表默认设备状态 说明：商户下默认仅有一个默认辅助终端设备，下单会使用该设备信息
○ 若商户使用渠道含需终端报备的渠道，请将默认设备开启，否则下单时无法携带报备的终端号，而导致下单失败

● 登录商户后台-商户中心-支付测试

○ 此处以条码支付方式为例，
■ 若选择公众号/小程序，请部署至线上/测试服务器，将运营平台系统配置中支付域名替换为解析后的二级域名如：https://pay.yintongzaixian.com, 且配置微信/支付宝的授权域名&支付授权目录。

● 点击下方<立即支付>按钮，发起支付（默认金额0.01元，可自行修改金额）
● 打开你的微信/支付宝，打开收付款页面，看到那个二维码+条码页面，手指点一下，会展示出条码下边+一串数字，把数字输入到输入框中（有扫码枪/扫码盒的同学可以使用扫码设备，扫码设备会自动回车触发<确认支付>），然后点击<确认支付>按钮调起支付。

看到以下信息，说明支付通道已经请求通了。如有其他报错提示，查看服务端（payment）日志，进行排查。（其他支付方式请自行探索）

点击对应的渠道，展开代理商参数配置页，进行对应配置

配置保存后点击上方费率配置项，进行代理商费率配置（单笔费配置和银联阶梯配置，不再赘述）

上述配置完成保存后，可关闭此页进行后续操作

统一下单

商户业务系统通过统一下单接口发起支付收款订单，店来宝支付网关会根据商户配置的支付通道路由支付通道完成支付下单。支付网关根据不同的支付方式返回对应的支付参数，业务系统使用支付参数发起收款。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/pay/unifiedOrder
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

终端设备信息说明

请求示例数据JSON

{
  "amount": 8,
  "extParam": "",
  "mchOrderNo": "mho1624005107281",
  "subject": "商品标题",
  "wayCode": "ALI_BAR",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
  "reqTime": "1624005107",
  "body": "商品描述",
  "version": "1.0",
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.yintongzaixianpay.cn",
  "signType": "MD5",
  "currency": "cny",
  "returnUrl": "",
  "mchNo": "M1623984572",
  "divisionMode": 1
}

返回参数

data数据格式

返回示例数据JSON

{
  "code": 0,
  "data": {
    "errCode": "ACQ.PAYMENT_AUTH_CODE_INVALID",
    "errMsg": "Business Failed【支付失败，获取顾客账户信息失败，请顾客刷新付款码后重新收款，如再次收款失败，请联系管理员处理。[SOUNDWAVE_PARSER_FAIL]】",
    "mchOrderNo": "mho1624005752661",
    "orderState": 3,
    "payOrderId": "P202106181642329900002"
  },
  "msg": "SUCCESS",
  "sign": "F4DA202C516D1F33A12F1E547C5004FD"
}

支付方式

channelExtra参数说明
当 wayCode=AUTO_BAR 或 wayCode=ALI_BAR 或 wayCode=WX_BAR 或 wayCode=YSF_BAR 时，channelExtra必须传auth_code，为用户的付款码值，channelExtra示例数据如：

{"authCode": "13920933111042"}

当 wayCode=ALI_JSAPI 时，channelExtra必须传buyerUserId，为支付宝用户ID，channelExtra示例数据如：

{"buyerUserId": "2088702585070844"}

当 wayCode=WX_JSAPI 或 wayCode=WX_LITE 时，channelExtra必须传openid，为微信OpenId， channelExtra示例数据如：

{"openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI"}

注意： 若当前为特约商户，并且商户使用的自己的公众号或者小程序获取到的openId时：
需要：

1. 商户自己的公众号或者小程序的AppId需要在服务商里进行关联， 请联系运营平台进行配置；
2. channelExtra参数中添加 subAppId 参数，该参数为商户的公众号或小程序的AppId，示例：

{ "openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI", "subAppId"："wx08b5a41f7a27abf1" }

当 wayCode=ALI_QR 或 wayCode=WX_NATIVE 时，channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为：codeUrl-二维码地址,codeImgUrl-二维码图片地址，不传payDataType默认返回codeUrl类型, channelExtra示例数据如：

{"payDataType": "codeImgUrl"}

当 wayCode=QR_CASHIER 时，channelExtra可以传payDataType和entryPageType。
entryPageType指定聚合码扫码时进入H5或小程序页面，默认为H5页面。h5-h5页面，lite-小程序页面。
payDataType设置返回支付数据支付类型，此时payDataType可以为：codeUrl-二维码地址,codeImgUrl-二维码图片地址，不传payDataType默认返回codeUrl类型, channelExtra示例数据如：

{"payDataType": "codeImgUrl"}

当 wayCode=ALI_WAP 时，channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为：form-返回自动跳转的支付表单,codeImgUrl-返回一个二维码图片URL,payUrl-返回支付链接，不传payDataType默认返回payUrl类型, channelExtra示例数据如：

{"payDataType": "form"}

当 wayCode=ALI_PC 时，channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为：form-返回自动跳转的支付表单,payUrl-返回支付链接，不传payDataType默认返回payUrl类型, channelExtra示例数据如：

{"payDataType": "form"}

查询订单

商户通过该接口查询订单，支付网关会返回订单最新的数据
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/pay/query
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
  "payOrderId": "P202106181104177050002",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "46940C58B2F3AE426B77A297ABF4D31E",
  "signType": "MD5",
  "reqTime": "1624006009",
  "mchNo": "M1623984572",
  "version": "1.0"
}

data数据格式

返回示例数据JSON

{
  "code": 0,
  "data": {
    "amount": 58,
    "appId": "60cc09bce4b0f1c0b83761c9",
    "body": "商品描述",
    "channelOrderNo": "2021061822001423031419593035",
    "clientIp": "192.166.1.132",
    "createdAt": 1623985457705,
    "currency": "cny",
    "extParam": "",
    "ifCode": "alipay",
    "mchNo": "M1623984572",
    "mchOrderNo": "mho1623985457320",
    "payOrderId": "P202106181104177050002",
    "state": 2,
    "subject": "商品标题",
    "successTime": 1623985459000,
    "wayCode": "ALI_BAR"
  },
  "msg": "SUCCESS",
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

关闭订单

商户通过该接口关闭订单，支付网关会对订单完成关闭处理。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/pay/close
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
  "payOrderId": "P202106181104177050002",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "46940C58B2F3AE426B77A297ABF4D31E",
  "signType": "MD5",
  "reqTime": "1624006009",
  "mchNo": "M1623984572",
  "version": "1.0"
}

data数据格式

返回示例数据JSON

{
  "code": 0,
  "data": {
    "errCode": '',
    "errMsg": ''
  },
  "msg": "SUCCESS",
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

支付通知

当订单支付成功时，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。
接口说明
适用对象：普通商户 特约商户
请求URL：该链接是通过统一下单接口提交的参数notifyUrl设置，如果无法访问链接，商户系统将无法接收到支付中心的通知。
请求方式：POST
请求类型：application/x-www-form-urlencoded
通知参数

以下扩展参数如需同步传递需在商户后台配置

返回结果
业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）
注意：返回的字符串必须是小写，且前后不能有空格和换行符。
通知示例数据JSON

{
    "amount": 5,
    "body": "商品描述",
    "clientIp": "192.166.1.132",
    "createdAt": "1622016572190",
    "currency": "cny",
    "extParam": "",
    "ifCode": "wxpay",
    "mchNo": "M1621873433953",
    "appId": "60cc09bce4b0f1c0b83761c9",
    "mchOrderNo": "mho1621934803068",
    "payOrderId": "20210525172643357010",
    "state": 3,
    "subject": "商品标题",
    "wayCode": "WX_BAR",
    "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

获取渠道用户ID

商户通过该接口获取渠道的用户ID，如微信的openID，支付宝的userId。该接口通过跳转获取到用户ID后，会跳转到商户上传的redirectUrl地址，并传递用户ID参数
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/channelUserId/jump
请求方式：GET
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
  "mchNo": "M1621873433953",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "wxpay",
  "redirectUrl": "https://www.yintongzaixianpay.cn",
  "sign": "A5C93D50743126ED91AA6ED96CDEEEF8",
  "signType": "MD5",
  "reqTime": "1622011236571",
  "version": "1.0"
}

当获取到渠道用户ID后，会301重定向到跳转地址，传递参数如下

完整跳转URL示例HTML

https://www.yintongzaixianpay.cn/toU?channelUserId=o6BcIwvSiRpfS8e_UyfQNrYuk2LI

返回码

请求示例数据JSON

{
  "payOrderId": "P202106181104177050002",
  "extParam": "",
  "mchOrderNo": "",
  "refundReason": "退款测试",
  "sign": "2762CDB48D5179281DB6C0995E4EEDE0",
  "reqTime": "1624007315",
  "version": "1.0",
  "channelExtra": "",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "mchRefundNo": "mho1624007315478",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.jeequan.com",
  "signType": "MD5",
  "currency": "cny",
  "mchNo": "M1623984572",
  "refundAmount": 4
}

返回参数

data数据格式

返回示例数据JSON

{
  "code": 0,
  "data": {
    "channelOrderNo": "2021061822001423031419593035",
    "mchRefundNo": "mho1624007315478",
    "payAmount": 58,
    "refundAmount": 4,
    "refundOrderId": "R202106181708358940000",
    "state": 2
  },
  "msg": "SUCCESS",
  "sign": "2843B811B7A75D56B7D1950362820875"
}

查询订单

商户通过该接口查询退款订单，支付网关会返回订单最新的数据
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/refund/query
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
  "refundOrderId": "P202106181105527690009",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "1484293FCAEAFE11DEC8949DB6B525A9",
  "signType": "MD5",
  "reqTime": "1624008199",
  "mchNo": "M1623984572",
  "version": "1.0"
}

data数据格式

返回示例数据JSON

{
  "code": 0,
  "data": {
    "appId": "60cc09bce4b0f1c0b83761c9",
    "channelOrderNo": "2021061822001423031419593035",
    "createdAt": 1623985552769,
    "currency": "cny",
    "extParam": "",
    "mchNo": "M1623984572",
    "mchRefundNo": "mho1623985552430",
    "payAmount": 58,
    "payOrderId": "P202106181104177050002",
    "refundAmount": 4,
    "refundOrderId": "P202106181105527690009",
    "state": 2,
    "successTime": 1623985554000
  },
  "msg": "SUCCESS",
  "sign": "E3F9F008FC5EF84BD782CCC7BE69DC5E"
}

退款通知

当退款完成时(成功或失败)，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。
接口说明
适用对象：普通商户 特约商户
请求URL：该链接是通过统一退款接口提交的参数notifyUrl设置，如果无法访问链接，商户系统将无法接收到支付中心的通知。
请求方式：POST
请求类型：application/x-www-form-urlencoded
通知参数

返回结果
业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）
注意：返回的字符串必须是小写，且前后不能有空格和换行符。
通知示例数据JSON

{
    "appId": "60cc09bce4b0f1c0b83761c9",
    "channelOrderNo": "2021061822001423031419593035",
    "createdAt": 1623985552769,
    "currency": "cny",
    "extParam": "",
    "mchNo": "M1623984572",
    "mchRefundNo": "mho1623985552430",
    "payAmount": 58,
    "payOrderId": "P202106181104177050002",
    "refundAmount": 4,
    "refundOrderId": "P202106181105527690009",
    "state": 2,
    "successTime": 1623985554000
}

1. 系统内服务商渠道参数配置（如何获取请联系三方支付公司）

登录代理商平台-代理商中心-费率配置-服务商参数配置-选择对应的三方支付公司渠道

渠道参数配置
○ <备注>下方参数配置为系统内使用渠道所必须的参数，请根据对应渠道文档/支付公司下发的参数进行配置（配置中可能会包含系统内自定义的参数，详见对应渠道文档说明/咨询店来宝技术人员）；
○ <备注>以上状态参数等为系统内参数配置；
■ 状态：渠道可用状态
■ 结算周期（自然日）：支付订单的结算周期（设置为 0 表示实时结算；设置为 -1 不计算分润）
■ 是否开启进件：渠道进件功能是否开启（以实际情况为准，源码是否支持，或自行拓展对接，或自行对接渠道）
■ 是否开启提现：一般指渠道侧商户未结算的金额（渠道商户钱包金额）的提现功能（以实际情况为准-说明同上）
■ 是否开启对账：渠道测与本系统的对账功能（以实际情况为准-说明同上）
■ 选择使用的oauth2条目：使用的默认oauth2配置条目配置
（oauth2疑问详见问题文档<服务商oauth2配置是干嘛的？

代理商中心-费率配置-参数/费率配置-选择对应的三方支付公司渠道-费率配置

○ 此项配置说明：
■ 此页展示的支付方式为当前渠道已对接且支持的支付方式（初始channel.sql中执行默认的支付方式，请勿自行在支付配置页中擅自修改勾选支付方式！！！<需要渠道接口支持/源码对接的呀！我亲爱的运营小可爱~>）
○ 关于费率填写：
■ 此页费率填写值应为与三方支付公司签订的支付费率，如：支付宝/微信签订费率为 0.25%，此页微信/支付宝支付方式统一填写0.25%即可。
■ 银联/云闪付支付方式需填写为银联阶梯费率模式（如有不同渠道文档中会有特别说明）

● 支付宝/微信单笔费率配置

● 银联阶梯费率配置（如渠道仅一个银联费率，则配置一样的费率值即可）

● 配置完毕保存后可关闭此页面进行后续配置
代理商中心-费率配置-服务商oauth2配置

2.配置服务商oauth2参数配置（如仅测试支付，不进行支付宝/微信公众号、小程序支付的可跳过该步骤，后续正式必须配置）

微信oauth2配置页说明

● 支付宝oauth2配置页说明
○ 如何创建三方应用/如何获取APPID：支付宝文档

完成以上oauth2配置后可关闭退出此页面

请求示例数据JSON

{"ifCode":"wxpay",
"entryType":"WX_CASH",
"amount":1,
"accountName":"",
"mchOrderNo":"mho1629106169045",
"sign":"3EB5A3B81E92DB41677E235363E7DDE3",
"transferDesc":"测试转账",
"reqTime":"1629106169",
"version":"1.0",
"appId":"60cc3ba74ee0e6685f57eb1e",
"accountNo":"a6BcIwtTvIqv1zXZohc61biryWok",
"clientIp":"192.166.1.132",
"signType":"MD5",
"currency":"CNY",
"mchNo":"M1623997351"
}

返回参数

data数据格式

返回示例数据JSON

{
    "code": 0,
    "data": {
        "accountNo": "1",
        "amount": 11,
        "channelOrderNo": "20210816110070001506260000372216",
        "mchOrderNo": "1629106288",
        "state": 2,
        "transferId": "T202108161731281310004"
    },
    "msg": "SUCCESS",
    "sign": "195BF6F112386F7FC8EA2AA7EECA1D33"
}

查询订单

商户通过该接口查询转账订单，支付网关会返回订单最新的数据
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/transfer/query
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
"appId":"60cc3ba74ee0e6685f57eb1e",
"sign":"D3C0CC231F3FC3D033650699BA099B39",
"signType":"MD5",
"reqTime":"1629106457",
"transferId":"T202108121543441860003",
"mchNo":"M1623997351",
"version":"1.0"
}

data数据格式

返回示例数据JSON

{
    "code": 0,
    "data": {
        "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
        "amount": 1,
        "appId": "6113805e42020495c62bd4cb",
        "createdAt": 1628818820011,
        "currency": "CNY",
        "entryType": "WX_CASH",
        "errCode": "OPENID_ERROR",
        "errMsg": "openid与商户appid不匹配【openid与商户appid不匹配】",
        "ifCode": "wxpay",
        "mchNo": "M1623997351",
        "mchOrderNo": "1628818820",
        "state": 3,
        "transferDesc": "测试",
        "transferId": "T202108130940200100001"
    },
    "msg": "SUCCESS",
    "sign": "A262DBD3D6182E8A0AEC90EF820F2A5A"
}

转账通知

当转账完成时(成功或失败)，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。
接口说明
适用对象：普通商户 特约商户
请求URL：该链接是通过转账申请接口提交的参数notifyUrl设置，如果无法访问链接，商户系统将无法接收到支付中心的通知。
请求方式：POST
请求类型：application/x-www-form-urlencoded
通知参数

返回结果
业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）
注意：返回的字符串必须是小写，且前后不能有空格和换行符。
通知示例数据JSON

{
        "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
        "amount": 1,
        "appId": "6113805e42020495c62bd4cb",
        "createdAt": 1628818820011,
        "currency": "CNY",
        "entryType": "WX_CASH",
        "errCode": "OPENID_ERROR",
        "errMsg": "openid与商户appid不匹配【openid与商户appid不匹配】",
        "ifCode": "wxpay",
        "mchNo": "M1623997351",
        "mchOrderNo": "1628818820",
        "state": 3,
        "transferDesc": "测试",
        "transferId": "T202108130940200100001"
    }

查询转账可用余额

调用该接口实时查询渠道侧的转账可用余额。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/transfer/balance/query
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'ifCode': 'alipay',
'appId': '60cc3ba74ee0e6685f57eb1e'
}

data数据格式

返回示例数据JSON

{
    "code": 0,
    "data": {
        "balanceAmount": 0
    },
    "msg": "SUCCESS",
    "sign": "5F16138F18AC367165B60CD97BA8CA27"
}

微信分账：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_1
支付宝分账： https://opendocs.alipay.com/open/20190308105425129272/intro
接口目录：

绑定分账用户

接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/receiver/bind
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': 'MD5MD5MD5MD5MD5MD5MD5MD5MD5MD5MD5MD5',
'mchNo': 'M1623997000',
'appId': '60cc3ba74ee0e6685f57e000',
'ifCode': 'wxpay',
'receiverAlias': '我的第一个账号',
'receiverGroupId': '100001',
'accType': '0',
'accNo': 'sfsfsd@qq.com',
'accName': '张三',
'relationType': 'OTHERS',
'relationTypeName': '我的员工',
'divisionProfit': '0.3' 
}

返回参数

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "accName": "张三",
        "accNo": "sfsfsd@qq.com",
        "accType": 0,
        "appId": "60cc3ba74ee0e6685f57eb1e",
        "bindState": 0,
        "divisionProfit": 0.3,
        "errCode": "NOAUTH",
        "errMsg": "无分账权限",
        "ifCode": "wxpay",
        "mchNo": "M1623997351",
        "receiverAlias": "我的第一个账号",
        "receiverGroupId": 100001,
        "relationType": "OTHERS",
        "relationTypeName": "我的员工"
    },
    "msg": "SUCCESS",
    "sign": "552CB91FA1E1DB378A534B377E4E9403"
}

发起订单分账

当订单下单时传入的分账模式 divisionMode = 2商户手动分账(解冻商户金额)，支持商户手动发起订单分账。
注意：需要在订单支付完成后（建议1分钟后）调用分账接口。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/exec
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'mchNo': 'M1623997351',
'appId': '60cc3ba74ee0e6685f57eb1e',
'payOrderId': 'P202108271011463510002',
'useSysAutoDivisionReceivers': '0',
'receivers': '[{"receiverGroupId":"","receiverId":"800029","divisionProfit":"0.0001"},{"receiverGroupId":"","receiverId":"800028","divisionProfit":"0.0002"}]' 
}

data数据格式

返回示例数据JSON

{
    "code": 0,
    "data": {
        "errCode": "unknown-sub-code",
        "errMsg": "Business Failed【未知的错误码ACQ.ROYALTY_ACCOUNT_NOT_EXIST】",
        "state": 2
    },
    "msg": "SUCCESS",
    "sign": "56836E18015DD7E4FAFE45380C0AD098"
}

订单分账查询

订单分账结果的查询。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/query
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'mchNo': 'M1623997351',
'appId': '60cc3ba74ee0e6685f57eb1e',
'payOrderId': 'P202108271011463510002',
'batchOrderId': 'D99832829483234'

data数据格式

records数据格式

返回示例数据JSON

{
"code":0,
"data":{
"batchOrderId":"D1792435159956271105",
"records":"[{\"accName\":\"A\",\"accNo\":\"A\",\"accType\":0,\"batchOrderId\":\"D1792435159956271105\",\"calDivisionAmount\":1980,\"divisionProfit\":0.200000,\"receiverAlias\":\"A\",\"receiverGroupId\":100001,\"receiverId\":800001,\"recordId\":1007,\"state\":1},{\"accName\":\"B\",\"accNo\":\"B\",\"accType\":0,\"batchOrderId\":\"D1792435159956271105\",\"calDivisionAmount\":990,\"divisionProfit\":0.100000,\"receiverAlias\":\"B\",\"receiverGroupId\":100001,\"receiverId\":800002,\"recordId\":1008,\"state\":1}]"
},
"msg":"SUCCESS",
"sign":"ABA5F4300D536E10CCB1FC677847773D"
}

查询分账用户的可用余额

调用该接口实时查询渠道侧的分账用户的可用余额。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/receiver/channelBalanceQuery
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': '800021',
'appId': '60cc3ba74ee0e6685f57eb1e'
}

data数据格式

返回示例数据JSON

{
    "code": 0,
    "data": {
        "balanceAmount": 0,
        "receiverId": 800021
    },
    "msg": "SUCCESS",
    "sign": "5F16138F18AC367165B60CD97BA8CA27"
}

对分账用户的渠道余额发起提现

调用该接口实时调起三方的提现接口， 将实时到结算银行卡。 建议调用前先调用余额查询接口。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/division/receiver/channelBalanceCashout
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数

请求示例数据JSON

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': 800021,
'cashoutAmount': 10,
'appId': '60cc3ba74ee0e6685f57eb1e'
}

data数据格式

返回示例数据JSON

{
    "code": 0,
    "data": {
        "receiverId": 801
        "state": 1,
    },
    "msg": "SUCCESS",
    "sign": "5F16138F18AC367165B60CD97BA8CA27"
}

协议规则

传输方式：采用HTTP/HTTPS传输
提交方式：采用GET/POST/PUT/DELETE 方式提交
字符编码：UTF-8

接口数据

金额：接口中所有涉及金额字段，数值类型为Long，单位精确到分。如：18 表示 18分。

接口地址

参数规范

1. 所有对外参数名称统一，参数命名使用驼峰样式，请求参数采用x-www-form-urlencoded格式发送。
2. 服务端返回数据为json格式，参数说明：

返回数据参考：
{ "code" : 0, "msg" : "success", "data" : { "appId" : "0695598130314a3682874b51e1022a6d", "appName" : "百汇董村点" } }

安全规范

1、服务端token约束

（1）服务端使用jwt方式生成token，客户端调用鉴权接口，服务端认证通过后，返回生成token数据。
（2）客户端在请求服务端接口时，需要在http请求头中增加iToken参数传递token到服务端，服务端会对该token值的真实性以及有效期进行验证。如：
iToken=eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiIyMDAwMDAwMCIsImNyZWF0ZWQiOjE1MTMwMDIzNjc0MzgsImlkIjoyMDAwMDAwMCwiZXhwIjoxNTEzNjA3MTY3fQ.HOJhm7SXE9D6_cleUMYduZAXUlEz3d78rTwTVv2Vdaxjz_HEyizL73T0aRcGFIHc8Qoni0RMqPBJ_NFXVUbubQ

2、涉及隐私相关的使用HTTPS

参数规范

交易金额：默认为人民币交易，单位为分，参数值不能带小数。
时间参数：所有涉及时间参数均使用精确到毫秒的13位数值，如：1622016572190。时间戳具体是指从格林尼治时间1970年01月01日00时00分00秒起至现在的毫秒数。

签名算法

签名生成的通用步骤如下
第一步： 设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
特别注意以下重要规则：
◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名；
◆ 参数名区分大小写；
◆ 验证调用返回或支付中心主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
◆ 支付中心接口可能增加字段，验证签名时必须支持增加的扩展字段
第二步： 在stringA最后拼接上key[即 StringA +"&key=" + 私钥 ] 得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。
如请求支付系统参数如下：Java

Map<String, Object> paramsMap = new HashMap<>();
        paramsMap.put("mchNo", "M1682391685");                   // 商户号
        paramsMap.put("appId", "6447428682ca7458118af79f");      // 应用ID
        paramsMap.put("mchOrderNo", "mho1694051705945");         // 商户订单号
        paramsMap.put("wayCode", "ALI_BAR");                     // 支付方式
        paramsMap.put("amount", 1L);                             // 金额，单位分
        paramsMap.put("currency", "CNY");                        // 币种，目前只支持cny
        paramsMap.put("clientIp", "192.166.1.132");              // 发起支付请求客户端的IP地址
        paramsMap.put("subject", "商品标题");                     // 商品标题
        paramsMap.put("body", "商品描述");                        // 商品描述
        paramsMap.put("notifyUrl", "https://www.jeequan.com");   // 异步通知地址
        paramsMap.put("reqTime", "1694051706");                  // 请求时间
        paramsMap.put("version", "1.0");                         // 接口版本号，固定：1.0
        paramsMap.put("signType", "MD5");                        // 签名类型
        paramsMap.put("channelExtra", "{\"authCode\":\"284957415846666792\"}");  // 渠道参数

待签名值：
amount=1&appId=6447428682ca7458118af79f&body=商品描述&channelExtra={“authCode”:”284957415846666792”}&clientIp=192.166.1.132&currency=CNY&mchNo=M1682391685&mchOrderNo=mho1694051705945&notifyUrl=https://www.yintongzaixianpay.cn&reqTime=1694051706&signType=MD5&subject=商品标题&version=1.0&wayCode=ALI_BAR&key=UNpEETkvMpqC9oDLBr9S2X7U92k462h3zhHiy7hj4xbw23PiWhMv6TCAQ2vh8PzynZXZYo9n6puxHkAHG7li6LZi8IpaQrshzydnBll64iKlb4U59ggiyCTaHJeqffiW
签名结果：924065BA077FA461A9B06D2E76E9ED3C
最终请求支付系统参数：
{“amount”:1,”mchOrderNo”:”mho1694051705945”,”subject”:”商品标题”,”wayCode”:”ALI_BAR”,”sign”:”924065BA077FA461A9B06D2E76E9ED3C”,”reqTime”:”1694051706”,”body”:”商品描述”,”version”:”1.0”,”channelExtra”:”{"authCode":"284957415846666792"}”,”appId”:”6447428682ca7458118af79f”,”clientIp”:”192.166.1.132”,”notifyUrl”:”https://www.yintongzaixianpay.cn","signType":"MD5","currency":"CNY","mchNo":"M1682391685"}

运营管理平台可以管理商户的私钥