HTTP 响应代码

本节概述了在使用 Yuno API 时可能遇到的常见错误代码和解决方法。

Yuno 使用标准 HTTP 响应代码来表示 API 请求的成功或失败。

2xx 范围内的代码通常表示成功。4xx 范围内的代码表示根据所提供的信息发生错误（如缺少参数等），5xx 范围内的代码表示内部错误。

示例

{
  "code": "INVALID_REQUEST",
  "messages": [
    "Invalid request."
  ]
}

错误的响应属性

code 字符串
错误代码状态属性。

message 字符串数组
返回的错误信息。

查看 Yuno 的 Rest API 返回哪些代码。

HTTP 状态代码	代码	说明
400 错误请求	`INVALID_REQUEST`	无效请求。
	`INVALID_PARAMETERS`	无效参数：列表 - [参数名]。
	`MISSING_PARAMETERS`	缺少参数：列表 - [参数名]。
	`INVALID_STATUS`	交易状态无效。
	`COUNTRY_NOT_SUPPORTED`	不支持的国家。
	`CURRENCY_NOT_ALLOWED`	该国不允许使用货币。
	`CUSTOMER_ID_DUPLICATED`	商户的客户 ID 是重复的。
	`INVALID_AMOUNT`	付款方式的金额无效。
	`INVALID_ACCOUNT_ID`	Yuno 的账户 ID 无效
	`INVALID_TRANSACTION`	交易 ID 无效
	`INVALID_API_VERSION`	无效的 API 版本。
	`INVALID_TRANSACTION_TYPE`	请求的交易类型无效。
	`CHARGEBACK_IN_PROCESS`	已对该交易进行扣款。
	`UNAVAILABLE_PAYMENT_METHOD`	付款方式不可用。
	`NOT_FOUND`	未找到资源。
	`UNEXPECTED_RESPONSE`	意外的服务响应。
	`BAD_REQUEST`	执行请求时出现错误。
	`INVALID_REPORT_ID`	报告 id 必须是 UUID。
	`INVALID_REPORT_TYPE`	报告类型无效。
	`INVALID_DATE_FORMAT`	开始/结束日期格式必须为 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。
	`REPORT_MAX_RANGE_ERROR`	最大范围日期为两个月。
	`REPORT_RANGE_ERROR`	开始日期必须在结束日期之前。开始/结束日期必须在现在之后。
	`REPORT_STATUS_ERROR`	报告尚未准备就绪，状态为 %s。
	`REPORT_EMPTY`	请求的报告为空。
	`PAYMENT_METHOD_NOT_FOUND`	[订阅] - 未找到与客户相关联的付款方式
	`PAYMENT_METHOD_STATUS_INVALID`	[用于订阅] - 付款方式为不允许付款的状态。
	`INCORRECT_PAYMENT_METHOD_TYPE`	[订阅] - 请求的支付方式类型与金库令牌不符。
	`SUBSCRIPTION_NOT_FOUND`	[订阅] - 未找到订阅。
	`INVALID_STATE`	[对于订阅] - 订阅状态不支持请求的操作。
	`INVALID_DATE`	[订阅] - 由于与可用日期冲突，无法恢复订阅。如果您想继续使用订阅，请更新可用日期并重试
	`INVALID_PARAMETERS`	[用于订阅] - 无效参数：列表 - [参数名]。
	`INVALID_CUSTOMER_FOR_TOKEN`	该交易使用的token 与另一个客户对象相关联。
	`PAYMENT_NOT_FOUND`	未找到付款。
	`TRANSACTION_NOT_FOUND`	未找到付款交易
	`CUSTOMER_NOT_FOUND`	未找到客户
	`CHECKOUT_SESSION_NOT_FOUND`	未找到结账会话或结账会话处于非活动状态
	`REPORT_NOT_FOUND`	未找到报告 ID
	`IDEMPOTENCY_DUPLICATED`	无效性是重复的。
401 未经授权	`INVALID_CREDENTIALS`	证书无效。
	`EXPIRED_CREDENTIALS`	过期证书。
	`UNKNOWN_IP_ADDRESS`	未注册的 IP 地址。
	`INVALID_TOKEN`	无效Token。
	`TOKEN_IN_USE`	所提供的token 目前正用于另一个请求。
403 禁止	`AUTHORIZATION_REQUIRED`	商家无权使用此 API。
405 不允许使用的方法	`UNSUPPORTED_METHOD`	不支持该方法。
500 内部服务器错误	`INTERNAL_ERROR`	内部错误。
504Gateway 超时	`REQUEST_TIMEOUT`	请求超时。