sendPaymentResult
当支付处理达到成功或失败的终态时,使用此接口向蚂蚁集团通知您的支付结果 。该接口用于未来的风险评估。
结构
报文由报文头和报文体构成,下文主要介绍报文体结构。
注意:将每个字段的数据类型设置为 String (数组类型的字段除外) 。这意味着您必须使用双引号 (" ") 将字段值括起来。例如:
- 如果某个字段的数据类型为 Integer 且值为 20,则将其设置为 “20”。
- 如果某个字段的数据类型为 Boolean 且值为 true,则将其设置为 “true ”。
入参
referenceTransactionId String REQUIRED
直接向买家提供服务或商品的商户分配的唯一ID,用于识别交易。
更多信息:
- 最大长度:64 字符
paymentStatus String REQUIRED
表示支付结果。有效值为:
SUCCESS
:表示支付成功。FAIL
:表示支付失败。
更多信息:
- 最大长度:16 字符
authorizationError Error
支付方式提供商提供的卡支付授权失败的原因。
提供这些信息有助于提升欺诈检测的准确性,提高支付成功率。
cardVerificationResult CardVerificationResult
卡支付方式的验证结果。
支付完成后传入该参数。
paymentMethodProvider String REQUIRED
支付方式提供商。
出参
result Result REQUIRED
接口调用的结果。
API Explorer
示例代码沙箱运行
请求
URL
请求体
响应
响应体
结果码
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
SUCCESS | S | 成功。 | 接口调用成功,无需执行任何操作。 |
ACCESS_DENIED | F | 访问被拒绝。 | 详细原因请联系蚂蚁集团技术支持。 |
INVALID_API | F | 调用的接口无效或未激活。 | 请联系蚂蚁集团技术支持解决问题。 |
INVALID_CONTRACT | F | 合约中的参数值与当前交易中的参数值不匹配。 | 检查合约中的参数值是否与当前交易中的参数值匹配。如果匹配,请联系蚂蚁集团技术支持排查问题。 |
KEY_NOT_FOUND | F | 未找到蚂蚁集团或商户的私钥或公钥。 | 检查私钥或公钥是否存在。如果不存在,请在蚂蚁集团开发者中心上传私钥。 |
MERCHANT_KYB_NOT_QUALIFIED | F | 由于商家的 KYB 状态,支付失败。该商户可能不符合 KYB 标准,或者 KYB 状态不符合此交易的条件。 | 详细原因请联系蚂蚁集团技术支持。 |
MERCHANT_NOT_REGISTERED | F | 商户未注册。 | 请通过注册接口注册商户。如果调用注册接口失败,请联系蚂蚁集团技术支持。 |
NO_INTERFACE_DEF | F | 接口未定义。 | 检查 URL 是否正确。请参见接口文档中的端点。 |
PARAM_ILLEGAL | F | 没有传递必传参数,或者存在非法参数。例如,非数字输入、无效日期或参数的长度和类型错误。 | 检查并验证当前接口所需的请求字段(包括请求头字段和请求体字段)是否正确传递且有效。 |
SYSTEM_ERROR | F | 发生系统错误。 | 请勿重试,请联系蚂蚁集团技术支持了解更多详情。 |
REQUEST_TRAFFIC_EXCEED_LIMIT | U | 请求流量超出限制。 | 再次调用该接口解决问题。若未解决,请联系蚂蚁集团技术支持。 |
UNKNOWN_EXCEPTION | U | 接口调用失败,原因未知。 | 再次调用接口解决问题。如仍未解决,请联系蚂蚁集团技术支持。 |