Skip to main content

错误代码 🚨

Hyperswitch使用错误代码、类型和消息来通信API调用期间的错误。有三种类型的错误代码:

错误代码类型描述
IR无效请求错误由API请求中的无效字段和值引起的错误
CE连接器错误来自连接器端的错误
HEHyperswitch错误来自Hyperswitch端的错误
错误代码HTTP状态码错误类型错误消息错误处理
IR_00501server_not_available此API正在开发中,即将推出不需要任何操作。如果您需要此功能,请联系Hyperswitch支持
IR_01401invalid_request_error未提供API密钥或使用了无效的API密钥。请在Authorization头中使用api-key(例如api-key: API_KEY)提供API密钥,或从控制面板创建一个新的API密钥在Authorization头中使用api-key(例如api-key: API_KEY)提供API密钥,或从控制面板创建一个新的API密钥
IR_02404invalid_request_error无法识别的请求URL请重新检查并输入正确的请求URL。参考我们的API文档
IR_03405invalid_request_errorHTTP方法不适用于此API请重新检查请求中使用的HTTP方法。参考我们的API文档
IR_04400invalid_request_error缺少必填参数:“字段名称”请传递缺失的必填参数。参考我们的API文档
IR_05422invalid_request_error“字段名称”包含无效数据。预期格式为“预期格式”请以预期格式传递数据。参考我们的API文档
IR_06400invalid_request_error“消息”参考我们的API文档以获取必填字段和格式
IR_07400invalid_request_error提供了无效的值:“字段名称”以预期格式为必填字段提供有效的值。参考我们的API文档
IR_08400invalid_request_error未提供客户端密钥提供在payments/create API响应中收到的客户端密钥
IR_09400invalid_request_error提供的client_secret与支付关联的client_secret不匹配为相应支付提供在payments/create API响应中收到的相同客户端密钥
IR_10400invalid_request_error客户已有现有授权/订阅在继续删除客户数据之前,请取消客户的活动授权/订阅
IR_11400invalid_request_error客户数据已被删除客户数据已被删除。不需要任何操作
IR_12400invalid_request_error达到最大退款尝试次数此支付的最大退款尝试次数已达到。请联系Hyperswitch支持以尝试对同一支付进行更多退款
IR_13400invalid_request_error退款金额超过支付金额请验证并传入小于或等于支付金额的退款金额
IR_14400invalid_request_error由于“字段名称”为“当前值”,此支付无法被“current_flow”。预期状态为“states”请验证支付的状态,并确保您正在执行当前支付状态允许的操作
IR_15400invalid_request_error客户的短暂密钥无效请为客户传入正确的短暂密钥
IR_16400invalid_request_error“消息”通常在涉及多个字段或先前提供的信息不满足某个条件时使用。参考我们的API文档以获取必填字段和格式
IR_17401invalid_request_error访问被禁止,使用了无效的JWT令牌请提供有效的JWT令牌以访问API
CE_00由连接器共享的状态码connector_error“消息”从连接器传递的错误代码和消息。有关错误的更多信息,请参考各自连接器的文档
CE_01400processing_error支付在与连接器授权期间失败。重试支付由于连接器授权期间的支付失败,请重试支付
CE_02400processing_error支付在与连接器身份验证期间失败。重试支付由于连接器身份验证期间的支付失败,请重试支付
CE_03400processing_error在与连接器处理时,捕获尝试失败在连接器端捕获失败。请重试支付
CE_04400processing_error卡片数据无效传递了无效的卡片数据。请传递有效的卡片数据
CE_05400processing_error卡片已过期卡片已过期。请传递有效的卡片数据
CE_06400processing_error退款在与连接器处理时失败。重试退款连接器端的退款处理失败。请重试退款
CE_07400processing_error在与连接器处理时,验证失败。重试操作连接器端的验证失败。请重试操作
HE_00500server_not_available出现错误请重试操作。如果错误仍然存在,请联系Hyperswitch支持
HE_01400duplicate_request重复的退款请求。已经使用退款ID尝试过退款请验证退款ID,如果退款已尝试,则不需要任何操作
HE_01400duplicate_request重复的授权请求。已经使用授权ID尝试过授权请验证授权ID,如果授权已创建,则不需要任何操作
HE_01400duplicate_request记录中已经存在具有指定详细信息的商户帐户请验证商户帐户详细信息,如果商户帐户已创建,则不需要任何操作
HE_01400duplicate_request记录中已经存在具有指定详细信息的商户连接器帐户请验证商户连接器帐户详细信息,如果商户连接器帐户已创建,则不需要任何操作
HE_01400duplicate_request记录中已经存在具有指定详细信息的支付方式请验证授权ID,如果授权已创建,则不需要任何操作
HE_02400object_not_found我们的记录中不存在退款请验证退款详情并输入有效详情
HE_02400object_not_found我们的记录中不存在客户请验证客户详情并输入有效详情
HE_02400object_not_found我们的记录中不存在支付请验证支付详情并输入有效详情
HE_02400object_not_found我们的记录中不存在支付方式请验证支付方式详情并输入有效详情
HE_02400object_not_found我们的记录中不存在商户帐户请验证商户帐户详情并输入有效详情
HE_02400object_not_found我们的记录中不存在商户连接器帐户请验证商户连接器详情并输入有效详情
HE_02400object_not_found我们的记录中不存在资源ID请验证资源ID并输入有效详情
HE_02400object_not_found我们的记录中不存在授权请验证授权详情并输入有效详情
HE_03503validation_error未配置且未在支付请求中传递返回URL请通过控制面板配置返回URL或通过更新您的商户帐户详情。或者,您可以在每个支付请求主体中传递返回URL
HE_03400validation_error无法通过Hyperswitch进行退款。请通过“connector”控制面板发起退款请从各自的连接器控制面板发起退款请求,因为连接器不为Hyperswitch提供退款API进行处理
HE_03400validation_error授权验证失败请再次验证授权详情并输入有效详情
HE_04400validation_error支付尚未成功。请传递成功的支付以启动退款请验证请求参数并重试支付。如果错误仍然存在,请联系Hyperswitch支持
HE_04400object_not_found未为给定支付ID找到成功支付请验证支付详情和状态,因为您只能尝试对成功状态的支付进行退款
HE_04400object_not_found请求中提供的连接器不正确或不可用请验证您的连接器配置并提供为您的帐户启用的有效连接器
HE_04400object_not_found我们的记录中不存在地址请验证地址详情并传递有效地址详情