API 参考

响应码

对照 Onerway 支付响应中的英文 message，查看中文说明和建议排查动作。

当 API 响应中的 respCode 不是 20000 时，可用本页定位错误类型、排查请求参数、判断是否需要客户换卡、重试或联系 Onerway 支持。接口响应中的 message 为英文；中文说明是为了方便中文读者理解而整理，不代表接口会返回中文 message。

respCode=20000 表示 Onerway 已处理请求，但不一定代表交易、退款、订阅或绑卡的最终业务结果。最终状态仍应结合接口文档、异步通知和查询接口确认。

发卡机构和收单机构拒绝通常与卡片、账户、发卡机构风控或通道状态有关。不要对硬拒绝、疑似欺诈、AML、法律/监管限制类错误盲目重试。

错误码范围

范围	Category	中文类别	数量
`11xxx`	System errors	系统错误	1
`12xxx`	Configuration errors	配置错误	11
`13xxx`	Parameter errors	参数错误	35
`132xx`	Subscription errors	订阅错误	16
`14xxx`	Refund errors	退款错误	15
`20xxx`	Risk control errors	风控错误	1
`30xxx`	Validation errors	校验错误	21
`40xxx`	Acquirer errors	收单机构错误	6
`50xxx`	3DS errors	3DS 错误	5
`60xxx`	Issuer errors	发卡机构错误	83
`70xxx`	General errors	通用错误	2

系统错误（11xxx）

错误码	message	中文说明	建议处理
`11001`	System exception	系统异常	联系 Onerway 支持

配置错误（12xxx）

错误码	message	中文说明	建议处理
`12001`	System configuration decline	系统配置拒绝	联系 Onerway 支持
`12002`	Merchant ID is disabled or settlement currency is not configured	商户号已停用或未配置结算币种	联系 Onerway 支持
`12003`	Card brand/3DS/Service is not supported	不支持该卡组织、3DS 或服务	联系 Onerway 支持
`12004`	Merchant Account is disabled or non-existent	商户账户已停用或不存在	联系 Onerway 支持
`12005`	Invalid transaction ID for SDK initialization	SDK 初始化交易 ID 无效	确认 SDK 初始化使用的交易号来自服务端响应；确认交易号未被篡改；确认下单接口与 SDK 使用同一环境
`12006`	Subscription payment information verification failed	订阅支付信息校验失败	仅适用于托管订阅（`selfExecute=1`）：确保订阅支付时间符合扣款频率
`12007`	Incorrect transaction ID	交易 ID 不正确	检查 `merchantNo`
`12008`	Invalid transaction IP	交易 IP 无效	检查请求中的 `transactionIp`
`12009`	Request channel timed out	请求通道超时	稍后重试
`12010`	Configuration error prevents the request from being processed	配置错误导致请求无法处理	联系 Onerway 支持确认交易类型已启用
`12011`	3DS/API request initialization failed	3DS/API 请求初始化失败	联系 Onerway 支持

参数错误（13xxx）

错误码	message	中文说明	建议处理
`13001`	Invalid appId	`appId` 无效	联系 Onerway 支持
`13002`	Invalid card number	卡号无效	检查卡号后重试
`13003`	Invalid transaction URL	交易 URL 无效	检查请求域名是否与已登记域名一致；联系 Onerway 支持
`13004`	Expired card	卡片已过期	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`13005`	Year must be 2 or 4 digits	年份必须为 2 位或 4 位数字	检查卡片信息后重试；请客户换用其他卡
`13006`	Invalid state, please fill in the correct state when the country is US, CA or CN.	国家/地区为 US、CA 或 CN 时，`state` 无效或缺失	检查请求中的 `state`（US、CA、CN 必填）
`13007`	Incorrect card information	卡片信息不正确	检查卡片信息后重试
`13008`	Repeat transaction rejected	重复交易被拒绝	确认交易是否已成功
`13009`	Card number is required	卡号不能为空	检查卡号后重试
`13010`	Unsupported card brand: MAESTRO	不支持 MAESTRO 卡	检查卡组织配置
`13011`	Decline - Invalid account number	账户号码无效导致拒绝	请客户联系发卡机构确认；请客户换用其他卡
`13012`	`billingAddress.city` is longer than 30 characters	`billingAddress.city` 长度不能超过 30 个字符	检查请求中的 `city`（最多 30 个字符）
`13013`	mpiInfo is required when risk3dsStrategy is EXTERNAL	`risk3dsStrategy=EXTERNAL` 时必须传入 `mpiInfo`	检查请求中的 `mpiInfo`
`13014`	Invalid transaction type	交易类型无效	检查请求中的 `txnType`
`13015`	merchantCustId is required for subscription	订阅场景必须传入商户客户号	检查请求中的 `merchantCustId`
`13016`	Subscription contract parameters are required	订阅合约参数不能为空	检查请求中的 `subscription`
`13017`	Billing information, email, and country are required	账单信息不能为空，且 `email` 与 `country` 必须填写	检查 `billingInformation.email` 和 `billingInformation.country`
`13018`	Invalid productType	`productType` 无效	检查请求中的 `productType`
`13019`	Invalid product information format	商品信息格式无效	检查 `txnOrderMsg.products`
`13020`	Invalid subscription frequency	订阅扣款频率无效	检查 `subscription.frequencyType` 和 `subscription.frequencyPoint`
`13021`	Transaction query time range cannot exceed 90 days	交易查询时间范围不能超过 90 天	检查 `startTime` 和 `endTime`
`13022`	Unsupported currency	不支持该币种	检查国家/地区与币种是否匹配
`13023`	Subscription contract unavailable	订阅合约不可用	检查订阅状态
`13024`	contractId or tokenId is required for subscription payment	订阅支付必须传入 `contractId` 或 `tokenId`	检查 `contractId` 和 `tokenId`
`13025`	Card year/month is invalid	卡片年份或月份无效	检查 `year` 和 `month`
`13026`	Invalid subProductType	`subProductType` 无效	检查 `subProductType`
`13027`	Duplicate order transaction	订单交易重复	确认请求是否已处理成功
`13028`	Query condition is required	查询条件不能为空	检查 `merchantTxnIds`、`transactionIds`、`startTime` 和 `endTime`
`13029`	Subscription contract expired	订阅合约已过期	确认订阅是否已过期
`13030`	Invalid transaction amount	交易金额无效	检查 `amount`
`13031`	PAN-only card does not support 3DS	PAN-only 卡不支持 3DS	换用支持 3DS 的卡
`13032`	Order has already been captured or canceled	订单已请款或已取消，不能再次请款	确认订单是否已请款或取消
`13033`	Parameters have already been used for the first subscription purchase	该参数组合已用于首次订阅支付	确认同一买家是否已用同一张卡完成订阅
`13034`	Invalid card verification code length	CVC 长度无效	检查 CVC 长度
`13035`	Refund amount is too small	退款金额过小	退款金额必须大于 0

订阅错误（132xx）

错误码	message	中文说明	建议处理
`13200`	Invalid self-execute setting	`Self execute` 设置无效	检查 `Self execute`
`13201`	Invalid email	邮箱无效	检查 `email`
`13202`	Invalid cycle count	`Cycle count` 无效	检查 `Cycle count`
`13203`	Invalid trial-from-plan setting	`Trial from plan` 设置无效	检查 `Trial from plan`
`13204`	Invalid trial days or trial end	`Trial days` 或 `trial end` 无效	检查 `Trial days` 或 `trial end`
`13205`	Invalid products information	商品信息无效	检查 `Products information`
`13206`	Invalid proration setting	`Proration` 设置无效	检查 `Proration`
`13207`	Invalid billing cycle anchor	`Billing cycle anchor` 无效	检查 `Billing cycle anchor`
`13208`	Invalid frequency type	订阅频率类型无效	检查 `frequency type`
`13209`	Invalid subscription request type	订阅请求类型无效	检查 `subscription request type`
`13210`	Invalid subscription period	订阅周期无效	检查 `subscription period`
`13211`	Invalid subscription frequency	订阅频率无效	检查 `subscription frequency`
`13212`	Invalid merchant customer number	商户客户号无效	检查 `Merchant customer number`
`13213`	Invalid contract number or token	合约号或 token 无效	检查 `contract number` 或 `token`
`13214`	Subscription validity is earlier than the current time	订阅有效期早于当前时间	检查 `Subscription validity`
`13215`	Invalid contract information	合约信息无效	检查 `contract information`

退款错误（14xxx）

错误码	message	中文说明	建议处理
`14001`	Refund failed	退款失败	检查交易状态
`14002`	Real-time refund is not supported	不支持实时退款	稍后重试
`14003`	Cumulative refund amount exceeds the transaction amount	累计退款金额不能大于交易金额	检查本次退款金额和累计退款金额
`14004`	Refund has already been processed and cannot be canceled	退款已处理，不能取消	取消前先检查退款状态
`14005`	Online refunds not supported	不支持线上退款	通过线下渠道手动处理退款
`14006`	Real-time refund not supported	不支持实时退款	改用延迟退款处理
`14007`	Refund not supported for this payment method	该支付方式不支持退款	通过其他渠道手动处理退款
`14008`	System automatic refund in progress	系统自动退款处理中	等待自动退款完成
`14009`	Only full refund allowed for chargeback transactions	拒付交易只允许全额退款	提交全额退款，不要提交部分退款
`14010`	Refund must use designated interface	退款必须使用指定接口	将退款请求发送到指定接口
`14011`	Online refund failed because orders are pending or rejected	订单待审核或已拒绝导致线上退款失败	先处理待审核或已拒绝订单
`14012`	Insufficient payout account balance	打款账户余额不足	确保打款账户余额充足
`14013`	Transaction does not support refund initiation	该交易不支持发起退款	联系 Onerway 支持
`14014`	Chargeback already exists, refund not supported	已存在拒付，不能再发起退款	不要重复退款；款项已通过银行或发卡机构退回
`14015`	Original transaction was not successful	原交易未成功	退款前核实原交易状态

风控错误（20xxx）

错误码	message	中文说明	建议处理
`20001`	High risk	高风险交易	确认客户身份；24 小时后重试或联系 Onerway 支持

校验错误（30xxx）

错误码	message	中文说明	建议处理
`30001`	Invalid IP address	IP 地址无效	检查请求中的 `ip`
`30002`	Invalid birthDate	`birthDate` 无效	检查 `birthDate`
`30003`	Invalid product	`product` 无效	检查 `product`
`30004`	Invalid merchantCustId	`merchantCustId` 无效	检查 `merchantCustId`
`30005`	Invalid productType	`productType` 无效	检查 `productType`
`30006`	Invalid appId	`appId` 无效	检查 `appId`
`30007`	Invalid number	卡号无效	检查卡号后重试
`30008`	Invalid card verification code	CVC 无效	检查 CVC 后重试
`30009`	Invalid pin	PIN 无效	请客户联系发卡机构确认；请客户换用其他卡
`30010`	Invalid expiry month or year	有效期月份或年份无效	检查有效期后重试；请客户换用其他卡
`30011`	Invalid cardholder name	持卡人姓名无效	检查持卡人姓名后重试
`30012`	Invalid country	国家/地区无效	检查 `country`
`30013`	Invalid state	州/省无效	检查 `state`
`30014`	Invalid city	城市无效	检查 `city`
`30015`	Invalid address	地址无效	检查 `address`
`30016`	Invalid email	邮箱无效	检查 `email`
`30017`	Invalid postalCode	邮编无效	检查 `postalCode`
`30018`	Invalid phone	电话无效	检查 `phone`
`30019`	Invalid account	账户无效	请客户联系发卡机构确认；请客户换用其他卡
`30020`	Invalid parameters	参数无效	参考 API 文档检查请求参数
`30021`	Invalid transaction URL	交易 URL 无效	联系 Onerway 支持审核并批准网站

收单机构错误（40xxx）

错误码	message	中文说明	建议处理
`40000`	Illegal parameter {field}	请求参数非法；`message` 中会指出具体字段名	按接口文档检查该字段的取值、格式与依赖条件
`40001`	Acquirer suspected fraud	收单机构疑似欺诈拒绝	确认客户身份，并换用其他卡重试
`40002`	Acquirer system failure	收单机构系统故障	稍后重试；请客户换用其他卡；联系 Onerway 支持
`40003`	Acquirer decline	收单机构拒绝	稍后重试；请客户换用其他卡
`40004`	Acquirer timeout	收单机构超时	稍后重试
`40005`	Missing or invalid acquirer parameters	收单机构参数缺失或无效	联系 Onerway 支持

3DS 错误（50xxx）

错误码	message	中文说明	建议处理
`50001`	3DS authentication required	需要完成 3DS 认证	重试并完成 3DS 认证；请客户换用其他卡
`50002`	3DS parameters error	3DS 参数错误	重试并完成 3DS 认证；请客户换用其他卡
`50003`	3DS authentication failure	3DS 认证失败	重试并完成 3DS 认证；请客户换用其他卡
`50004`	3DS system error	3DS 系统错误	重试并完成 3DS 认证；请客户换用其他卡
`50030`	Order canceled	订单已取消	确认订单状态后再处理

发卡机构错误（60xxx）

错误码	message	中文说明	建议处理
`60001`	Refer to card issuer	请联系发卡机构	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60002`	Refer to card issuer, special condition	请联系发卡机构，存在特殊条件	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60003`	Invalid merchant	商户无效	联系 Onerway 支持
`60004`	Pick up card (no fraud)/Capture card	需要收卡（非欺诈）	请客户联系发卡机构确认，或换用其他卡
`60005`	Do not honor	发卡机构拒绝授权	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60006`	Issuer processing error	发卡机构处理错误	稍后重试，或请客户换用其他卡
`60007`	Pick up card, special condition (fraud account)	需要收卡，疑似欺诈账户	请客户联系发卡机构确认，或换用其他卡
`60012`	Invalid transaction	交易无效	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60013`	Invalid amount or Currency conversion field overflow	金额无效或币种转换字段溢出	检查交易金额或币种；联系 Onerway 支持
`60014`	Invalid account number	账户号码无效	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60015`	Invalid issuer	发卡机构无效	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60019`	Re-enter transaction	需要重新提交交易	检查报文格式；检查地址信息
`60021`	No action taken	未采取处理动作	请客户联系发卡机构确认；请客户换用其他卡
`60025`	Unable to locate record in file	无法定位相关记录	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60028`	File temporarily not available for update or inquiry	文件暂时无法更新或查询	重新发起交易
`60030`	Format error	报文格式错误	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60039`	No credit account	无信用账户	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60041`	Lost card, pick up card (fraud account)	遗失卡，需要收卡，疑似欺诈账户	请客户联系发卡机构确认，或换用其他卡
`60043`	Stolen card, pick up (fraud account)	被盗卡，需要收卡，疑似欺诈账户	请客户联系发卡机构确认，或换用其他卡
`60046`	Closed account	账户已关闭	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60051`	Insufficient funds/over credit limit	余额不足或超过授信额度	请客户联系发卡机构确认额度；请客户换用其他卡
`60052`	No checking account	无支票账户	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60053`	No savings account	无储蓄账户	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60054`	Expired card or expiration date missing	卡片已过期或缺少有效期	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60055`	PIN incorrect or missing/Invalid PIN	PIN 不正确或缺失	请客户联系发卡机构确认，或换用其他卡
`60057`	Transaction not permitted to issuer/cardholder	发卡机构或持卡人不允许该交易	请客户联系发卡机构确认，或换用其他卡
`60058`	Transaction not permitted to acquirer/terminal	收单机构或终端不允许该交易	请客户联系发卡机构确认，或换用其他卡
`60059`	Suspected fraud	疑似欺诈	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60061`	Exceeds approval amount limit	超过授权金额限制	请客户联系发卡机构确认，或换用其他卡
`60062`	Restricted card (card invalid in region or country)/Restricted card	受限卡或该地区/国家不可用	请客户联系发卡机构确认，或换用其他卡
`60063`	Security violation (source is not correct issuer)/Security violation	安全校验失败	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60064`	Transaction does not fulfill AML requirement	交易不满足 AML 要求	不要重试；复核交易风险
`60065`	Exceeds withdrawal frequency limit	超过取现频次限制	请客户联系发卡机构确认；请客户换用其他卡；联系 Onerway 支持
`60070`	PIN data required or contact card issuer	需要 PIN 数据或联系发卡机构	请客户联系发卡机构确认，或换用其他卡
`60071`	PIN Not Changed	PIN 未变更	请客户联系发卡机构确认，或换用其他卡
`60074`	Different value than that used for PIN encryption errors	PIN 加密错误相关值不匹配	请客户联系发卡机构确认，或换用其他卡
`60075`	Allowable number of PIN entry tries exceeded	PIN 输入尝试次数已超限	请客户联系发卡机构确认，或换用其他卡
`60076`	Invalid or unsolicited reversal account information	冲正账户信息无效或不存在	请客户联系发卡机构确认，或换用其他卡
`60077`	Invalid/nonexistent "From Account" specified	来源账户无效或不存在	请客户联系发卡机构确认，或换用其他卡
`60078`	Blocked card or invalid account	卡片未激活、临时锁定或账户无效	请客户联系发卡机构确认卡片是否已激活；请客户换用其他卡
`60079`	Reversed or card life-cycle restriction	交易已冲正或卡生命周期受限	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60080`	No financial impact or issuer system unavailable	无资金影响或发卡系统不可用	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60081`	PIN cryptographic error or domestic debit not allowed	PIN 加密错误或本地借记交易不允许	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60082`	Card authentication value failed or issuer policy decline	卡片认证值校验失败或发卡机构策略拒绝	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60083`	Fraud/Security (Mastercard use only)	欺诈或安全原因拒绝	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60084`	Invalid Authorization Life Cycle	授权生命周期无效	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60086`	PIN verification is not possible	无法验证 PIN	当天内重试；如适用，尝试非 PIN 交易
`60087`	Purchase Amount Only, No Cash Back Allowed	仅允许消费金额，不允许现金返还	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60088`	Cryptographic failure	加密校验失败	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60089`	Financial position information is not available or PIN retry required	无法获取财务状态信息或 PIN 需重试	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60090`	Cutoff is in progress	Cutoff 处理中	请客户联系发卡机构确认，或换用其他卡
`60091`	Issuer or authorization system unavailable	发卡机构或授权系统不可用	24 小时后重试；请客户联系发卡机构确认；请客户换用其他卡
`60092`	Unable to route transaction	交易无法路由	联系 Onerway 支持
`60093`	Transaction violates legal or regulatory requirements	交易违反法律或监管要求	请客户联系发卡机构确认；不要重试
`60094`	Duplication transaction detected	检测到重复交易	确认交易是否已成功
`60096`	System malfunction	系统故障	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`60100`	Exceeds authentication frequency limit	超过认证频次限制	请客户联系发卡机构确认；请客户换用其他卡；联系 Onerway 支持
`60101`	Cancelled	交易已取消	请客户联系发卡机构确认；请客户换用其他卡；联系 Onerway 支持
`60102`	Duplicate transaction	重复交易	确认交易是否已成功
`60103`	Soft decline	软拒绝	请客户换用其他卡，或完成 3DS challenge
`60104`	Hard decline	硬拒绝	不要重试
`60105`	Refund failed	退款失败	联系 Onerway 支持
`60106`	Customer did not pay before the order timed out	用户未在有效时间内完成支付，订单已超时关闭	请客户在订单有效时间内完成支付
`60129`	Suspected Counterfeit Card	疑似伪卡	请客户联系发卡机构确认；请客户换用其他卡
`6001A`	Additional customer authentication required	需要额外客户认证	请客户换用其他卡，或完成 3DS 认证
`6001Z`	Authorization system inoperative	授权系统不可用	请客户联系发卡机构确认，或换用其他卡
`6006P`	Verification data failed	验证数据失败	检查卡片信息后重试；完成 3DS 认证；请客户换用其他卡
`600B1`	Surcharge amount not permitted on Visa cards or EBT food stamps (U.S. acquirers only)	Visa 卡或美国 EBT 食品券不允许收取附加费	请客户换用其他卡
`600B2`	Surcharge amount not supported by debit network issuer.	借记网络发卡机构不支持附加费	请客户换用其他卡
`600N0`	Issuer forces stand-in processing	发卡机构要求走 STIP 代授权处理	检查卡片信息后重试；完成 3DS 认证；请客户换用其他卡
`600N3`	Cash service not available	现金服务不可用	请客户联系发卡机构确认；稍后重试；调整金额；请客户换用其他卡
`600N4`	Cash request exceeds issuer or approved limit	现金请求超过发卡机构或已批准限额	请客户联系发卡机构确认；调整金额；请客户换用其他卡
`600N5`	Ineligible for resubmission	不符合重新提交条件	请客户联系发卡机构确认；请客户换用其他卡
`600N7`	Decline for card verification code failure	CVC 校验失败导致拒绝	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`600N8`	Transaction amount exceeds preauthorized approval amount	交易金额超过预授权批准金额	确认请款金额不超过预授权金额
`600P5`	Denied PIN unblock—PIN change or unblock request declined by issuer	发卡机构拒绝 PIN 解锁请求	请客户联系发卡机构确认，或换用其他卡
`600P6`	Denied PIN change—requested PIN unsafe	发卡机构拒绝 PIN 变更请求	请客户联系发卡机构确认，或换用其他卡
`600Q1`	Card Authentication failed	卡片认证失败	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡
`600R0`	Stop this payment	停止本次支付	不要重试；联系 Onerway 支持
`600R1`	Stop all future payments	停止所有后续支付	不要重试；联系 Onerway 支持
`600R2`	Transaction does not qualify for Visa PIN	交易不符合 Visa PIN 条件	请客户联系发卡机构确认，或换用其他卡
`600R3`	Stop all merchants	停止所有商户交易	不要重试；联系 Onerway 支持
`600Z3`	Unable to go online; offline declined	无法联机，离线拒绝	检查卡片信息后重试；请客户联系发卡机构确认；请客户换用其他卡

通用错误（70xxx）

错误码	message	中文说明	建议处理
`70001`	Common decline	通用拒绝	联系 Onerway 支持
`70002`	Unknown decline	未知拒绝	联系 Onerway 支持

拒付状态变化通知

通知拒付状态变化，不进行重试。