• auto-gen TOC: {:toc}

商户接入都能印共同体支付，调用API必须遵循以下规则：

签名生成的通用步骤如下： 第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。 特别注意以下重要规则：

• 参数名ASCII码从小到大排序（字典序）；
• 如果参数的值为空不参与签名；
• 参数名区分大小写；
• 验证调用返回或都能印主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
• 都能印接口可能增加字段，验证签名时必须支持增加的扩展字段

第二步，在stringA最后拼接上key得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。 举例： 假设传送的参数如下：

mchId： 10000100
body： test
nonceStr： ibuaiVcKdpRxkhJA

第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：

stringA="body=test&mchId=10000100&nonceStr=ibuaiVcKdpRxkhJA";

第二步：拼接API密钥：

stringSignTemp=stringA+"&key=192006250b4c09247ec02edce69f6a2d" //注：key为商户平台设置的密钥key
sign=MD5(stringSignTemp).toUpperCase()="9A0A8659F005D6984697E2CA0A9CF3B7" //注：MD5签名方式

最终得到最终发送的数据：

{
    "appid": "wxd930ea5d5a258f4f",
    "mch_id": "10000100",
    "device_info": "1000",
    "body": "test",
    "nonce_str": "ibuaiVcKdpRxkhJA",
    "sign": "9A0A8659F005D6984697E2CA0A9CF3B7"
}

都能印支付API接口协议中包含字段nonceStr，主要保证签名不可预测。我们推荐生成随机数算法如下：调用随机数函数生成，将得到的值转换为字符串。

商户通过该接口进行交易的创建下单

https://www.dounengyin.net/apis/pay/dny/unifiedorder

以下字段在return_code为SUCCESS返回

以下情况需要调用关单接口：商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。

https://www.dounengyin.net/apis/pay/dny/closeorder

以下字段在return_code为SUCCESS返回

当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，都能印共同体将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上

https://www.dounengyin.net/apis/pay/dny/refund

以下字段在return_code为SUCCESS返回

支付完成后，都能印会把相关支付结果和用户信息发送给商户，商户需要接收处理，并返回应答。

对后台通知交互时，如果都能印收到商户的应答不是成功或超时，都能印信认为通知失败，都能印会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但都能印不保证通知最终能成功。 （通知频率为15/15/30/180/，单位：秒）

注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。

特别提醒：商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致，防止数据泄漏导致出现“假通知”，造成资金损失。

该链接是通过【统一下单API】中提交的参数notifyUrl设置，如果链接无法访问，商户将无法接收到微信通知。

通知url必须为直接可访问的url，不能携带参数。示例：notifyUrl：“https://www.xxx.com/pay/notify.html”

{
	"amount": "11000",
	"attach": "2018032954",
	"channelId": "dny",
	"mchId": "hslhys",
	"mchOrderNo": "CO20180329541527561027826",
	"payUser": "测试--测试",
	"result_code": "SUCCESS",
	"sign": "446A324F538241FDF7F1AC73DBEDE300",
	"sign_type": "MD5",
	"transactionId": "20180529103026487013100001702200"
}