Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

sendPaymentResult

POST /v1/risk/payments/sendPaymentResult

当支付处理达到成功或失败的终态时,使用此接口向蚂蚁集团通知您的支付结果 。该接口用于未来的风险评估。 

结构

报文由报文头和报文体构成,下文主要介绍报文体结构。

注意将每个字段的数据类型设置为 String (数组类型的字段除外) 。这意味着您必须使用双引号 (" ") 将字段值括起来。例如:

  • 如果某个字段的数据类型为 Integer 且值为 20,则将其设置为 “20”。
  • 如果某个字段的数据类型为 Boolean 且值为 true,则将其设置为 “true ”。 

Request parameters

referenceTransactionId String  REQUIRED

直接向买家提供服务或商品的商户分配的唯一ID,用于识别交易。  

More information:

  • Maximum length: 64 characters

paymentStatus String  REQUIRED

表示支付结果。有效值为: 

  • SUCCESS:表示支付成功。 
  • FAIL:表示支付失败。  

More information:

  • Maximum length: 16 characters

authorizationError Error  

支付方式提供商提供的卡支付授权失败的原因。 

提供这些信息有助于提升欺诈检测的准确性,提高支付成功率。 

Show child parameters

cardVerificationResult CardVerificationResult  

卡支付方式的验证结果。

支付完成后传入该参数。 

Show child parameters

paymentMethodProvider String  REQUIRED

支付方式提供商。

Response parameters

result Result  REQUIRED

接口调用的结果。 

Show child parameters
API Explorer
Sample CodesRun in Sandbox

Request

URL
Request Body

Response

Response Body


Result/Error codes

CodeValueMessageFurther action
SUCCESSS成功

接口调用成功,无需执行任何操作。

ACCESS_DENIEDF访问被拒绝。

详细原因请联系蚂蚁集团技术支持。

INVALID_APIF调用的接口无效或未激活。

请联系蚂蚁集团技术支持解决问题。

INVALID_CONTRACTF合约中的参数值与当前交易中的参数值不匹配。

检查合约中的参数值是否与当前交易中的参数值匹配。如果匹配,请联系蚂蚁集团技术支持排查问题。

KEY_NOT_FOUNDF未找到蚂蚁集团或商户的私钥或公钥。

检查私钥或公钥是否存在。如果不存在,请在蚂蚁集团开发者中心上传私钥。

MERCHANT_KYB_NOT_QUALIFIEDF由于商家的 KYB 状态,支付失败。该商户可能不符合 KYB 标准,或者 KYB 状态不符合此交易的条件。

详细原因请联系蚂蚁集团技术支持。

MERCHANT_NOT_REGISTEREDF商户未注册。

请通过注册接口注册商户。如果调用注册接口失败,请联系蚂蚁集团技术支持。

NO_INTERFACE_DEFF接口未定义

检查 URL 是否正确。请参见接口文档中的端点。

REQUEST_TRAFFIC_EXCEED_LIMITU请求流量超出限制。

再次调用该接口解决问题。若未解决,请联系蚂蚁集团技术支持。

PARAM_ILLEGALF没有传递必传参数,或者存在非法参数。例如,非数字输入、无效日期或参数的长度和类型错误。

检查并验证当前接口所需的请求字段(包括请求头字段和请求体字段)是否正确传递且有效。

SYSTEM_ERRORF发生系统错误。

请勿重试,请联系蚂蚁集团技术支持了解更多详情。

UNKNOWN_EXCEPTIONU接口调用失败,原因未知。

再次调用接口解决问题。如仍未解决,请联系蚂蚁集团技术支持。