收款消息通知接口

功能描述

当下面场景发生时会调用此接口通知商户
1、收款订单需要审核且需要客户提交凭证资料时会通知客户
2、收款订单审核退回,需客户补充资料时回通知客户
3、收款订单审核通过或拒绝时会通知客户

异步通知场景

场景 汇元通收款通知返回的状态
status 收款状态 proofStatus 凭证上传状态 reviewStatus 审核状态
用户首次汇款 PROCESSING(处理中) INIT(待上传) INIT(初始化)
商户上传凭证 PROCESSING(处理中) SUCCESS(已上传) WAIT(待审核)
审核退回待补充资料 PROCESSING(处理中) WAIT_ADD(待补充材料) RETURN(审核退回)
审核拒绝入账失败 REFUND_INIT(待退款) SUCCESS(已上传) REFUSE(审核拒绝)
审核拒绝退款完成 REFUND_SUCCESS(退款成功) SUCCESS(已上传) REFUSE(审核拒绝)
审核通过入账成功 BOTH_SUCCESS(已入账) SUCCESS(已上传) SUCCESS(审核通过)
用户再次汇款无需审核 BOTH_SUCCESS(已入账) INIT(待上传) NOT_NEED(无需审核)

通知参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户在汇元通的唯一编号
partnerId 服务商编号 服务商在汇元通的唯一编号
id 收款订单号 收款订单编号
accountNo VA账号 全球收款账号
currency 币种 币种
amount 收款金额 分为单位,1元=100分
feeAmount 收款手续费 分为单位,1元=100分
establishmentFeeAmount VA开户费 全球收款账号开户费
tradeType 汇款方式 ACH
TT
ACT
FPS
CHATS
proofStatus 凭证上传状态 INIT:待上传;
WAIT_ADD:待补充材料;
SUCCESS:已上传;
NOT_NEED:无需上传。
status 收款状态 INIT:初始化;
PROCESSING、GS1_SUCCESS、GS2_SUCCESS:处理中;
BOTH_SUCCESS:已入账;
REFUND_INIT:待退款;
REFUND_SUCCESS:已退款;
createDateTime 收款时间 收款时间
senderAccountName 汇款账户名称 汇款账号
senderAccountNo 汇款账号 汇款账号
reviewStatus 审核状态 NOT_NEED:无需审核;
INIT:初始化;
WAIT:待审核;
SUCCESS:成功;
RETURN:退回;
REFUSE:拒绝。
reviewRemark 审核意见 审核意见
senderCountry 国家代码 国家代码(两位) ,如US
hmac 参数签名 汇元通生成的参数签名结果,验签过程请参考《Geoswift加解密流程规范》

示例

{ "amount": "10000", "senderAccountNo": "SMITHA VANCHI RTGS HKD CASA", "proofStatus": "INIT", "createDateTime": 1725589724000, "merchantId": "G30016690", "accountNo": "799310000344", "hmac": "HzmwgXJXe1FThtDyYgnhYTQotMc4KKw==", "currency": "HKD", "reviewStatus": "INIT", "id": "2c9b929491c12d810191c5299c0b00c1", "partnerId": "G84600130", "status": "PROCESSING" }