交易状态和响应代码

每笔付款都有一个或多个相关交易。以下文档涵盖交易类型、状态代码，以及获得 HTTP 200 状态并处理交易后的说明。

工作流程

交易类型

类型	说明
`PURCHASE`	直接购买交易。
`AUTHORIZE`	与授权相关的交易。主要用于银行卡支付。
`CAPTURE`	捕获先前授权的交易。
`REFUND`	之前已批准交易的退款。
`CANCEL`	取消之前待处理的交易。
`VERIFY`	与信用卡验证相关的交易。
`CHARGEBACK`	与扣款相关的交易。
`THREE_D_SECURE`	首次购买的 3DS 验证交易。
`FRAUD_SCREENING`	欺诈筛查与欺诈核查相关联。

交易代码

每次交易，您都会收到 response_code 详细信息。与每种状态相关的详细信息如下。使用以下按钮导航到所需内容。

成功状态

获奖情况

创建状态

待定状态

拒绝状态

错误状态

过期状态

丢失状态

预防状态

成功状态

SUCCEEDED 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`SUCCEEDED`	交易成功	不适用	0,8,10,11,16,32
`FRAUD_VERIFIED`	由欺诈提供商验证的交易	不适用	-
`SUCCEEDED_THREE_D_SECURE`	3DS 验证成功	不适用	-

获奖情况

WON 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`REVIEW_WON`	收单银行拒绝退款	不适用	-

创建状态

CREATED 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`ACTION_REQUIRED`	付款已创建，但需要用户执行额外操作。这种情况出现在 3D Secure 身份验证流、支付方法重定向、需要continuePayment 的Headless SDK 流或带有额外步骤的异步支付方法中。检查 `redirect_url` 或 `sdk_action_required` 领域，以便采取下一步行动。	不适用	-
`SUCCEEDED`	交易创建成功	不适用	-
`RECEIVED`	收到的交易	不适用	-

待定状态

PENDING 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`CHALLENGE_REQUIRED`	交易等待挑战完成	不适用	-
`IN_REVIEW`	已将扣款文件发送给医疗服务提供者，正在对其进行分析	不适用	-
`PENDING_FRAUD_REVIEW`	欺诈提供商正在分析交易	不适用	-
`PENDING_PROVIDER_CONFIRMATION`	交易等待确认	不适用	-
`PENDING_REVIEW`	等待欺诈审查确认的交易	不适用	-

拒绝状态

📘
一些下降包括 merchant_advice_code (MAC) 表示是否重试以及何时重试。参见 Merchant Advice Codes (MAC).

DECLINED 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`ACCOUNT_STATUS`	请联系您的欺诈提供商以核实您的账户状态。	不适用	-
`ACQUIRE_CONTINGENCY`	无法获取服务	软	22, 80, 90, 91, 92, 96
`AUTHENTICATION_ATTEMPT`	未完成身份验证尝试	不适用	-
`AUTHENTICATION_FAILED_THREE_D_SECURE`	3D 验证失败	不适用	-
`BAD_FILLED_INFO`	卡片与发卡机构提供的参数不符	硬质	30,89
`BANK_NOT_SUPPORTED`	开关不支持的银行	软	31
`CALL_FOR_AUTHORIZE`	收单行致电收单银行安全部门	软	66
`CANCELLED_BY_USER`	用户取消	软	17
`COUNTRY_NOT_SUPPORTED`	由于不支持的国家/地区，此交易无法处理	硬质	-
`CURRENCY_NOT_ALLOWED`	不允许使用货币	硬质	-
`DECLINED_BY_BANK`	被银行拒绝。请咨询发卡行	软	-
`DECLINED_BY_PROVIDER`	被提供方拒绝。请参阅提供方数据	软	-
`DISABLED`	限制卡	软	-
`DO_NOT_HONOR`	不兑现	软	5
`DUPLICATED_TRANSACTION`	重复传送交易	软	26,94
`EXPIRED`	已过期的替代付款方式	软
`EXPIRED_CARD`	过期卡	硬质	33,54
`FIRST_USE`	首次使用受阻	软	78
`FRAUD_VALIDATION`	违反安全规定	软	34, 59, 63, 64
`FRAUD_VERIFICATION_DECLINED`	-	-	-
`INSUFFICIENT_FUNDS`	资金不足	软	51
`INVALID_AMOUNT`	无效金额	软	13,64
`INVALID_CARD_DATA`	卡片与发卡机构提供的参数不符。	硬质	56
`INVALID_CARD_NUMBER`	卡片与发卡机构提供的参数不符。	硬质	14
`INVALID_API`	尝试使用未经授权的 IP 地址验证付款	硬质	-
`INVALID_API_VERSION`	无效的应用程序接口版本	硬质	-
`INVALID_CREDENTIALS`	在 Yuno 中设置的欺诈提供商凭据无效。	硬质	-
`INVALID_ISSUER`	无效发行人	软	15
`INVALID_MERCHANT`	无效商户或服务提供商	软	3
`INVALID_PARAMETERS`	参数无效	硬质	-
`INVALID_SECURITY_CODE`	卡的安全码无效	硬质	56,82
`INVALID_STATUS`	无效状态	软	-
`INVALID_RESPONSE_FORMAT`	提供程序返回的响应体格式无效	软	-
`INVALID_TRANSACTION`	尝试的交易无效	硬质	12,23
`ISSUER_VIOLATION`	发卡银行因账户违规而拒绝交易。	软	93
`MISSING_PARAMETERS`	参数缺失	硬质	-
`NO_RETRY_LIFE_CYCLE`	无重试生命周期	硬质	79
`NO_RETRY_POLICY`	无重试政策	硬质	82
`NO_RETRY_SECURITY`	无重试安全	硬质	83
`RETRY_AFTER_1_H`	1 小时后重试	硬质
`RETRY_AFTER_24_H`	24 小时后重试	硬质
`RETRY_AFTER_2_D`	2 天后重试	硬质
`RETRY_AFTER_4_D`	4 天后重试	硬质
`RETRY_AFTER_6_D`	6 天后重试	硬质
`RETRY_AFTER_8_D`	8 天后重试	硬质
`RETRY_AFTER_10_D`	10 天后重试	硬质
`REJECTED_THREE_D_SECURE_REQUIRED`	3DS 验证拒绝	软	-
`REFER_TO_CARD_ISSUER`	被银行拒绝。请咨询发卡行	软	01
`REPORTED_LOST`	丢失的卡片	硬质	41
`REPORTED_STOLEN`	被盗卡，领取	硬质	43
`REQUESTS_EXCEEDED`	已达到提供方账户的请求上限。	软	-
`RESTRICTED_BY_BANK`	被银行拒绝。请参阅发卡行的特殊条件	软	62
`TERMINAL_ERROR`	您的商户账户未针对交易进行适当配置	软	58
`THREE_D_SECURE_REQUIRED`	反欺诈提供商需要对 3DS 进行挑战，以进一步验证。	软
`TRANSACTION_NOT_FOUND`	交易未找到	硬质	25
`UNAVAILABLE_PAYMENT_METHOD`	不支持请求的功能	硬质	-
`UNSUPPORTED_OPERATION`	不支持请求的功能	硬质	40
`UNKNOWN_ERROR`	未知错误	软	-
`USER_RESTRICTION`	不允许持卡人进行交易	硬质	57

Merchant Advice Codes (MAC)

这些代码将在处理拒付交易时提供有用的指导。您可以在我们的公共 API 响应中找到这些字段：

transactions.merchant_advice_code 和 transactions.merchant_advice_code_message:Yuno-normalized 字段，提供标准化代码和有关拒绝的解释。
transactions.provider_data.merchant_advice_code 和 transactions.merchant_advice_code_message:原始代码和来自提供商的信息。

请参考 Merchant Advice Codes (MAC)了解更多信息。

Merchant Advice Codes (MAC)

商户通知代码为发卡行/提供商提供重试行为和政策方面的指导。当出现拒付时，使用 MAC 来确定是否重试以及建议的时间。

商家建议代码	说明	提供方 MAC 代码
`UPDATE_INFORMATION`	需要更新/补充的信息	01 - 提供最新账户信息
`TRY_AGAIN_LATER`	10 天后重试	02 - 稍后再试
`DO_NOT_TRY_AGAIN`	请勿重试	03 - 不再尝试
`REQUIREMENTS_NOT_FULFILLED`	Token 要求未满足	04 - 未满足Token 要求
`NO_RETRY_LIFE_CYCLE`	无重试生命周期	21 - 取消经常性计划
`RETRY_AFTER_1_H`	1 小时后重试	24 - 1 小时后重试（资金不足）
`RETRY_AFTER_24_H`	24 小时后重试	25 - 24 小时后重试（资金不足）
`RETRY_AFTER_2_D`	2 天后重试	26 - 2 天后重试（资金不足）
`RETRY_AFTER_4_D`	4 天后重试	27 - 4 天后重试（资金不足）
`RETRY_AFTER_6_D`	6 天后重试	28 - 6 天后重试（资金不足）
`RETRY_AFTER_8_D`	8 天后重试	29 - 8 天后重试（资金不足）
`RETRY_AFTER_10_D`	10 天后重试	30 - 10 天后重试（资金不足）
`NO_RETRY_POLICY`	无重试政策	40 - 非充值预付卡
`NO_RETRY_SECURITY`	无重试安全	42 - 超过制裁分数
`MULTIPLE_USE_CARD`	多用途虚拟卡	43 - 多用途虚拟卡

拒绝状态

REJECTED 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`COUNTRY_NOT_SUPPORTED`	-	硬质	-
`CURRENCY_NOT_ALLOWED`	-	硬质	-
`INVALID_PARAMETERS`	-	硬质	-
`INVALID_REQUEST`	-	硬质	-
`INTERNAL_ERROR`	-	硬质	-
`MISSING_PARAMETERS`	-	硬质	-

错误状态

ERROR 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`ERROR`	未知内部错误	软	-
`PROVIDER_ERROR`	错误。授权过程中出现未知错误	软	6
`PROVIDER_INTERNAL_ERROR`	内部错误	软	98
`PROVIDER_INVALID_CREDENTIALS`	证书无效	硬质	-
`PROVIDER_INVALID_REQUEST`	无效请求	硬质	-
`PROVIDER_TIMEOUT`	收到答复太晚	软	68
`PROVIDER_UNKNOWN_ERROR`	未知错误	软	-
`OPERATION_NOT_SUPPORTED`	提供商不支持此操作	硬质	-
`TO_REVERSE`	交易将被撤销	硬质	-
`PROVIDER_INVALID_RESPONSE`	无效响应	硬质	20
`PROVIDER_INVALID_API_VERSION`	无效的应用程序接口版本	硬质	-

过期状态

EXPIRED 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`EXPIRED_BY_PROVIDER`	-	不适用	-

丢失状态

LOST 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`CLOSED`	-	不适用	-
`EXPIRED`	-	不适用	-
`PARTIALLY_CHARGEBACKED`	-	不适用	-
`REVIEW_LOST`	扣款争议败诉	不适用	-

预防状态

PREVENTED 状态详情

响应代码	说明	硬/软下降	ISO 8583 代码
`PREVENTED`	提供方/网络偏离预先争议。无需证据。终端。	不适用	-

备注

PREVENTED 只适用于与 type = CHARGEBACK 当提供商/网络显示有争议时。在这些情况下，Yuno 只发送扣款 webhook，而不发送退款 webhook。

扣款的具体响应代码

有关详细信息，请参阅 "扣款指南 "部分的原因代码页面。

CREATED 状态详情

响应代码	响应信息	类别	说明
`EMV_LIABILITY_SHIFT_COUNTERFEIT`	EMV 责任转移仿冒欺诈	欺诈	持卡人声称他们没有授权或参与你们处理的交易。
`EMV_LIABILITY_SHIFT_NOT_COUNTERFEIT`	EMV 责任转移非伪造欺诈	欺诈	持卡人声称他们没有授权或参与你们处理的交易。
`CARD_PRESENT_FRAUD`	其他欺诈--银行卡环境	欺诈	持卡人声称他们没有授权或参与在有卡环境下进行的按键输入或无人值守交易。
`NON_CARD_PRESENT_FRAUD`	其他欺诈 - 无卡环境	欺诈	持卡人没有授权或参与在无卡环境下进行的交易，如互联网、邮购、电话订购等。
`SCHEME_MONITORING_PROGRAM`	其他欺诈--计划监督方案	欺诈	计划欺诈监测方案
`NO_AUTHORIZATION`	无授权	授权	商家未获得正确有效的授权。
`DECLINED_AUTHORIZATION`	拒绝授权	授权	授权请求收到拒绝回复，商家完成交易。
`LATE_PRESENTMENT`	逾期提交	处理错误	交易未在规定时间内发送给 Visa。
`INCORRECT_TRANSACTION_CODE`	交易代码不正确	处理错误	持卡人声称国际交易的折算收费金额不正确。
`INCORRECT_CURRENCY`	不正确的货币	处理错误	商家在交易货币方面出现一个或多个错误
`INCORRECT_ACCOUNT_NUMBER`	账号不正确	处理错误	授权书中的帐号与交易中使用的帐号不符。
`INCORRECT_AMOUNT`	金额不正确	处理错误	持卡人声称他们同意支付的金额与收取的金额不同。
`DUPLICATE_PROCESSING`	重复处理/以其他方式支付	处理错误	一次交易被处理两次或两次以上。
`INVALID_DATA`	无效数据	处理错误	使用无效或错误数据获得授权。
`PRODUCT_OR_SERVICE_NOT_RECEIVED`	未收到的商品/服务	客户纠纷	持卡人声称没有收到他们订购的商品或服务。
`CANCELED_RECURRING_TRANSACTION`	取消经常性交易	客户纠纷	经常性交易取消后仍在处理。
`PRODUCT_OR_SERVICE_ISSUE`	与描述不符或有缺陷的商品/服务	客户纠纷	持卡人声称货物与描述不符。
`COUNTERFEIT_MERCHANDISE`	假冒商品	客户纠纷	经鉴定，这些商品为假冒商品。
`MISREPRESENTATION`	虚假陈述	客户纠纷	持卡人的银行收到持卡人的通知，声称销售条款失实。
`CREDIT_NOT_PROCESSED`	贷记未处理	客户纠纷	持卡人的银行收到持卡人的通知，称他们收到的授权、信贷或作废交易收据尚未处理。
`PRODUCT_OR_SERVICE_CANCELED`	取消的商品/服务	客户纠纷	持卡人的银行收到持卡人的通知，称他们退还了商品或取消了服务，但退款并未出现在持卡人的 Visa 对账单上。
`ORIGINAL_TRANSACTION_NOT_ACCEPTED`	不接受原始信用交易	客户纠纷	最初的贷记不被接受。
`CASH_TRANSACTION_VALUE`	未收到现金或押金交易额	客户纠纷	持卡人未在自动取款机上提取全额现金。
`CUSTOMER_AGREEMENT`	需提供客户交易或协议证明。	客户纠纷	发卡机构要求商家提供持卡人签名的收据副本或任何其他证明客户同意消费的文件。通常是为了核实持卡人提出异议或不承认的有卡交易。