# 常见问题:
1、正式的API接口文档地址？
答： 正式环境的API文档为：https://doc.paycools.com，在商户获取正式环境的账号时，发送的账号邮件上也会有正式环境的商户后台地址。
2、UAT接口链接地址，生产环境接口链接地址？
答： UAT和生产环境接口链接地址为域名+接口名。
UAT域名：https://api-uat.paycools.com
正式环境域名请上线时询问Paycools相关人员
如下图UAT接口所示：
该接口接口地址为：https://api-uat.paycools.com/api/v1/payment
3、如何录入基础对接信息？
答: 登录商户后台选择应用管理页面，进入应用列表，选择右上角”+”。添加商户应用，填写基础对接信息。之后，点击提交，应用就录入成功了。
PS：当前一个商户只能录入一个应用信息。
4、商户应用添加时填写的回调地址有什么区别？分别对应API的哪个回调接口？
答：在应用录入时，需要填写回调接口，其中商户回调接口对应API接口中的”商户回调通知接口”，QR回调对应API接口中”QRCODE还款回调接口”，Transfer回调对应API中的”Bank Transfer还款回调通知接口”。静态二维码和bank transfer只有成功的回调， 没有还款失败的回调。对应关系如图所示：
5、各个回调通知如何区分？
答： 在回调的参数中有eventName字段可以区分是哪种交易方式，在”商户回调通知接口”中，例如：在商户回调通知接口中，eventName返回“disbursement.success”，表示代付成功，eventName返回“payment.success”表示BillsPayment方式还款成功。
PS：在商户回回调通知接口中，会回调通知代付接口和BillPayment接口的结果。
6、秘钥如何获取？
答： 在录入应用信息后，在录入成功的应用中选择详情，进入“商户引用详情”页面，然后在"秘钥"列点击"编辑"，进行邮箱验证，就可以显示秘钥及公钥信息。
7、公钥、私钥和秘钥有什么区别？
答： 公钥和私钥：公钥和私钥是由商户自己生成，私钥商户自己保存，公钥在应用录入时传给PayCools，在之后调用PayCools的接口，需要商户按照PayCools指定的签名方式将请求参数和私钥进行签名，之后Paycools根据录入时的公钥进行解密，签名方式：
秘钥：秘钥由Paycools在录入商户应用信息成功后派发，用于在Paycools回调商户系统时，验证信息的正确性，商户需要使用秘钥对Paycools传过来的参数进行签名，对比签名结果。
签名流程为：
8、appId是什么，如何获取？
答： appId是商户录入应用信息之后，经过Paycools审核，在PayCools后台生成的商户应用唯一标识。可以在商户后台用户列表中查看。
9、appName如何传入？
答： appName传入的是商户应用的名称，必填字段，但是现在并不会校验字段内容。
10、mchOrderId如何传入，作用是什么？
答： 在代付中，mchOrderId表示商户的打款商户订单号，该字段不能重复。
在代付中，则表示此次代付请求的唯一标识。
在收款中，是当前账期的唯一标识，商户可以根据自己的业务需求，确定mchOrderId是某一个客户还是每一个订单，在回调时，商户可以通过回调的mchOrderId,确定这笔还款是哪个商户的还款，或者那一笔账单的还款。同一个mchOrderId可以使用三种不同的还款方式，但是同一个还款方式种，mchOrderId不能重复。
如：mchOrderId绑定的是一个人，每次mchOrderId的成功回调，商户就可以认为是绑定的商户还款了。
mchOrderId绑定的是一个账单，每次mchOrderId的成功回调，商户就可以认为是绑定的账单还款了。
11、IdempotencyId是什么，有什么作用？
答： IdempotencyId由商户传入，格式为：字母+数字，10-30位，请求中该字段表示: 商户真实的待打款订单id的加密字符串
代付用法:
- 商户真实的待打款订单id的加密字符串
- 当商户出现代付失败是应客户打款账号错误，修改后需发起重试：则 IdempotencyId加密字符串可以不变，mchOrderId修改后发起重试（IdempotencyId待打款订单id的加密字符串， mchOrderId单次请求唯一标识）
12、如何在UAT环境下给账户充值？正式环境如何充值？
答： 在UAT环境下，登录UAT商户后台，在“数据”-“余额”界面中，点击“充值”进入充值页面
在充值页面中，选择充值到哪一个银行，点击下一步。
输入充值的金额，点击“提交”。
提交成功后，可以在Paycools对接群中联系Paycools工作人员进行审核，审核通过之后，商户余额就会增加，UAT环境不需要真实的打款。
在正式环境中，用户需要保留真实的银行打款凭证，然后在商户系统提交了充值申请，充值申请流程和UAT环境相同。之后，联系Paycools相关人员，将真实打款凭证发给相关人员，便于Paycool确定是否已经充值以及确定商户。
PS：正式环境中可以先打款后提交充值申请，也可以先提交充值申请后打款。
13、amount如何传入？有最大/最小金额限制吗？
答： amount的单位是分，现在没有最小金额和最大金额的限制，最大/最小金额由上游渠道限制。
在还款接口中的minAmount和maxAmount字段现在为保留字段。
14、如何模拟收款/代付？
答： 模拟还款：登录用户页面，在 “模拟还款管理”-“模拟Bill Payment还款”页面中进行模拟还款。填写参数，点击“submit”,之后Paycool会将还款通知发给商户系统。模拟还款现在只支持Bill Payment和QR Code。
模拟付款：登录用户页面，在 “模拟还款管理”-“模拟代付”页面中进行模拟代付。代付需要在UAT环境中创建 一个代付订单之后,通过模拟代付去模拟该订单成功或者失败的场景，并从Paycools系统发送回调通知。
15、放款钱包账户手机号如何填入？
答: 在代付接口中，如果Paycool代付类型”payMethodCode”是电子钱包”EWALLET”,那么收款人账号”accountNo”就需要填写收款人开通电子钱包所填写的手机号，手机号格式应为09开头。
16、BillsPayment批量更新接口的作用是什么？
答： BillsPament批量更新接口是更新已创建还款账单当前还款可用渠道的VA静态码的接口。
BankTranfer批量更新接口同理。
17、BillsPayment创建接口和批量创建接口的区别？
答： BillsPayment单个创建接口一次只能创建一种渠道的VA静态码，BillsPayment可以通过”channelCode”字段，传入多个channelCode,从而生成所选渠道的VA静态码。
批量创建接口生成短链样式如图所示：
通过选择不同的渠道，可以展示相应渠道的VA静态码和还款指引。
PS：建议使用批量创建接口生成VA静态码。