# 通知回调
# 使用场景
用户发起支付，当交易完成之后，Supefina支付系统会通过调用商户提供的回调接口告知交易结果详情，商户需要按规则接受并实现自己的处理逻辑。
# 回调配置
配置回调地址有两种方式：
- 联系运营人员在系统后台配置回调地址（商户维度，可修改）
- 发起代收代付时将回调地址作为入参传入（订单维度，不可修改）
回调逻辑：
当订单完成时，优先使用请求入参时传入的回调地址，若入参未传入回调地址，使用系统后台配置的商户回调地址
使用场景：
- 商户集成了多租户系统，不同的租户有不同回调地址，且不打算自己封装回调，可通过入参传入不同的回调地址
- 若在系统使用过程中有修改回调地址的需求，在修改前还存在未结算的订单，使用系统后台配置回调地址，不会丢失回调通知
# 注意
- 支付系统不保证一定能成功通知，在某些情况下可能会通知失败导致商户收不到回调，包括但不限于商户提供的回调地址有误
- 商户系统对于结果通知的内容需要做签名验证，签名和验签逻辑见“签名”
- 在商户入驻时，商户需要将回调地址提供给工作人员进行配置
- 某些渠道在某些情况下可能存在多次回调的情况，如：先成功，再失败，需要自行增加处理逻辑
- 代收代付使用同一个回调接口，通过transactionType字段辨别代收代付
# 接口提交方式
# 通知参数
| 字段名 | 变量名 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| Supefina订单号 | supefinaOrderId | String | ||
| 商户订单号 | merOrderId | String | ||
| 商户编号 | merId | String | ||
| 交易状态 | status | String | - 00：预下单 - 01：成功 - 02：交易失败 - 03：支付拒绝 - 04：下单失败 | |
| 国家编号 | countryId | String | - MEX：墨西哥 - COL：哥伦比亚 - PER：秘鲁 - ARG：阿根廷 | |
| 交易类型 | transactionType | String | - 01：代收 - 02：代付 | |
| 消息 | msg | String | ||
| 订单金额 | amount | BigDecimal | ||
| 实收金额 | realityAmount | BigDecimal | ||
| 预售手续费 | fee | BigDecimal | ||
| 实收手续费 | realityFee | BigDecimal | ||
| 交易成功时间 | successTime | Date | ||
| 顾客名字 | customerName | String | ||
| 扩展参数 | extraData | JSONObject | ||
| 随机字符串 | nonceStr | String | 随机字符串长度不能超过32 | |
| 签名 | sign | String | ||
| 付款参考标识符 | identifier | String | 如：墨西哥代收返回Clabe号 |