支付确认

功能概述

本接口用于在调用协议支付预下单提交接口后,进行支付确认来完成支付。

接口地址

https://apis.5upay.com/cashier/receipt/payment

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 订单号 varchar(50) 此参数传下单接口传递的requestId参数,不可改动。 M
partnerId 服务商id varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
paymentOrderId 支付订单id varchar(32) 下单接口调用成功后返回的paymentOrderId。 M
kaptchaCode 短信验证码 varchar(6) 下单接口调用成功后会通知商户是否会发送验证码,如果发送验证码需要用户将验证码传入此参数。 C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "hmac": null, "merchantId": "100000050", "requestId": "1527746602492", "paymentOrderId": "1gde138a36dg90dyh38d59fd12462dtb ", "kaptchaCode": "123456" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
requestId 订单号 同请求参数
paymentOrderId 收款订单id 同请求参数
status 请求状态 SUCCESS 成功(此状态为请求成功而不是支付成功,请以异步通知和查询结果为准)
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "100000050", "requestId": "1527746602492", "paymentOrderId": "1gde138a36dg90dyh38d59fd12462dtb ", "status": "SUCCESS", "hmac": null }