Union Secure (IE0036)

描述

本部分仅适用于使用Union Secure（IE0036）的支付。

请求方法

1. 方法: POST

签名

签名方法与v3版本相同（签名文档）

out_trade_no = OTN123456789
pay_type=IE0011
API_KEY = 123456789abcdefg

signature_string = out_trade_no=OTN123456789&pay_type=IE0011123456789abcdefg

signature = sha_256(signature_string)

参数

参数名	类型	是否可为空	是否参与签名	描述
trade_no	string(64)	No	No	订单号，来自上游系统
out_trade_no	string(32)	No	Yes	商户订单号，需唯一，建议格式为日期(YYYYmmddHHiiss) + 18位随机数
status	int(1)	No	No	支付状态（0: 未支付, 1: 已支付, 2: 结算前退款, 3: 已支付并结算, 4: 结算后退款）
status_str	string(20)	No	No	状态的可读字符串表示
pay_type	string(8)	No	Yes	支持的支付类型
pay_type_str	string(20)	No	No	支付类型的可读字符串表示
sign	string(20)	No	No	SHA256签名

示例

• Curl

curl --location '{NOTIFY_URL}' \
--form 'trade_no="{trade_no}"' \
--form 'out_trade_no="20220202001"' \
--form 'status="1"' \
--form 'status_str="Paid"' \
--form 'pay_type="IE0036"' \
--form 'pay_type_str="Union Secure"' \
--form 'sign="{SHA256_SIGN}"'

预期结果

处理完回调请求后，请返回如下格式的JSON响应：

{
    "success":true,
    "error_code":0,
}

回调规则

1. 支付完成后，我们会立即通知您的服务器。

2. 如果我们未收到预期响应，我们将在支付后1分钟、2分钟、5分钟、10分钟、30分钟等时间点再次通知您的服务器。

3. 如果我们仍未收到期望的响应，将停止通知您。

其他支付类型

描述

这是针对其他支付回调（如支付宝或微信支付）的说明。

请求方法

1. 方法: GET

签名

签名字符串由以下部分组成：{trade_no} + {out_trade_no} + {trade_status} + {API_KEY}

trade_no = 123456789
out_trade_no = OTN123456789
trade_status = SUCCESS
API_KEY = 123456789abcdefg

signature_string = 123456789OTN123456789SUCCESS123456789abcdefg
signature = md5(signature_string)

参数名

参数名	类型	是否可为空	是否参与签名	描述
trade_no	string(64)	No	Yes	订单号，来自上游系统。
out_trade_no	string(32)	No	Yes	订单号，应唯一，建议使用日期(YYYYmmddHHiiss) + 18位随机数
trade_status	string(20)	No	Yes	订单状态，如 SUCCESS / FAILED
pay_type	string(8)	No	No	支持的支付类型
sign	string(20)	No	No	MD5签名

示例

• Curl

curl --location --request GET '{NOTIFY_URL}' \
--form 'trade_no="{trade_no}"' \
--form 'out_trade_no="20220202001"' \
--form 'trade_status="SUCCESS"' \
--form 'pay_type="{PAY_TYPE}"' \
--form 'pay_type_str="Union Secure"' \
--form 'sign="{MD5_SIGN}"'

预期结果

如果你完成了对回调请求的处理，请返回一个字符串，如：

SUCCESS

回调规则

1. 一旦支付完成，我们会立即通知你的服务器。

2. 如果我们没有收到预期的响应，我们将按照上游系统的通知规则再次通知你的服务器。

   • 支付宝：4分钟、10分钟、10分钟、1小时、2小时、6小时、15小时
   • 微信支付：0秒、15秒、15秒、30秒、3分钟、30分钟、1小时

3. 如果我们仍然无法收到预期的响应，我们将停止通知你的服务器。