上传收款凭证接口(商户-->汇元通,必做接口)

功能描述

当上传订单凭证上传状态为:INIT和WAIT_ADD时,商户需要调用此接口上传凭证

接口地址

请求地址:https://api.geoswift.com/va/order/uploadProof

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在汇元通系统的唯一身份标识 M
partnerId 服务商编号 varchar(9) 二级商户上属服务商商户在汇元通系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
id 收款订单号 varchar(50) 收款订单号 M
proofList 文件名称 varchar(200) 支持支持上传PNG、JPG、JPEG、PDF、ZIP,最多上传5个文件,文件大小不超过10MB M
otherProof 其他凭证信息 varchar(1000) 其他凭证信息 O
hmac 参数签名 varchar(512) 商户生成的参数签名结果,获取hmac的方法请参考《Geoswift加解密流程规范》 M

示例

{ "merchantId": "G30016690", "hmac": "hIopVKWqIacimQEcth3JWruQ==", "proofList": [ "test.TXT", "test.pdf", "test.pdf", "test.pdf", "test.pdf" ], "id": "2c9b929491c12d810191c5299c0b00c1", "partnerId": "G84600130" }

请求返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 订单号 服务商编号
id 收款订单号 收款订单编号
status 请求状态 SUCCESS:成功
FAILED:失败
ERROR:错误
businessStatus 上传状态 INIT:待上传;
WAIT_ADD:待补充材料;
SUCCESS:已上传;
NOT_NEED:无需上传。
completeDateTime 上传时间 上传时间
errorCode 错误码 错误码
errorMessage 错误描述 错误描述
hmac 参数签名 汇元通生成的参数签名结果,验签过程请参考《Geoswift加解密流程规范》

示例

{ "completeDateTime": "2024-09-06 10:29:35", "hmac": "fkCY9/iZPaMXDeTT87XmExqzc8emMd4Am9UdKkePA==", "id": "2c9b929491c12d810191c5299c0b00c1", "merchantId": "G30016690", "partnerId": "G84600130", "status": "SUCCESS" }