代付核验二次确认回调

代付核验二次确认回调

现通知 Payout 代付链路新增安全增强能力：代付核验二次确认回调核验功能为可选功能，非强制接入，商户可自主选择是否开启与联调。

针对已主动开启 Payout Verification 功能的商户：
通过 Payout API 发起出金时，系统会先创建状态为Pending的出金订单，同时向您配置的 webhook 地址推送核验通知。
👉 请您在10 秒内返回 result 参数（approve / reject），确认是否放行这笔出金：

返回approve：我方继续执行出金交易；

返回reject / 回调请求超时：出金直接中断，订单标记失败，失败原因为商户拒绝或接口请求失败。

⚠️ 重要区分：该核验回调不等同于出金结果通知notifyUrl。notifyUrl依旧用于接收出金执行完成后的最终交易状态。

开发规范：
为了保证安全性，建议设置平台IP为白名单，验证签名。
请求方式：POST
请求BODY：查看请求参数文档
返回BODY：查看返回参数文档

平台出口IP

dev环境

prod环境

120.79.228.164

统一请求头信息

"Content-Type", "application/json"
"country_code, "NG"
"signature", "LIEd8lq9ZhBW1NEbTVDDVQAZVlO5v5abjzvFE7f66/n7ksezE3RXXy7Mf+1/i+bCoVWRxowVeMXATYd98Ddj28fK4tzAiK5OQ7xhZsDhR7omlwEOFdjS4PQOylIp19kBjtX/L9jeyxYRPZjhV1lR8BGf7ECxYdkmmdkDH1NfntQ="

代付核验二次确认回调签名算法：
使用平台RSA公钥对请求BODY用SHA256WithRSA算法对请求头签名进行验签。

String signResult = RsaUtil.verifyWithSha256(bodyStr);

Webhook RUL

签名平台公钥

请求参数：

Field	Type	Whether Required	Length	Example	Description
merchantOrderId	string	Yes	64	20765127845487245514	商户请求订单号
currency	string	Yes	32	NGN	币种
amount	string	Yes	32	10000	订单金额（100元）
accountName	string	Yes	32	Glosupply Test	收款方姓名
accountNo	string	Yes	32	0002071346	收款方账号
bankCode	string	Yes	32	A000773	收款方银行编码
notifyUrl	string	No	32	https://ver.webhook.com	接收代付结果通知URL

返回参数：

Field	Type	Whether Required	Length	Example	Description
result	string	Yes	32	approve	result: approve/ reject；

请求参数：

{
	"merchantOrderId": "20765127845487245514",
	"currency": "NGN",
	"amount": 10000,
	"accountName": "Glosupply Test",
	"accountNo": "0002071346",
	"payeeAmount": 0002071346,
	"bankCode": "A000773",
	"notifyUrl": "https://ver.webhook.com"
}

返回参数:

通过

拒绝

{
     "result":"approve"
}