---
title: 错误
description: 无卡验证 REST API 端点返回的 HTTP 状态码和错误响应概览。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- 区域解决方案
- [无卡验证](/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification)
- [集成](/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview)
- [API](/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis)
- 错误

**本页内容# 错误

### 简介​

无卡验证使用常规的 HTTP 响应代码来表示 API 请求的成功或失败。
一般规则如下：

2xx 范围内的代码表示请求成功。
4xx 范围内的代码表示参数不正确或不完整（例如，遗漏了必填参数，或与第三方的操作失败等）。
5xx 范围内的代码表示无卡验证产品服务器发生错误。

无卡验证还会生成以 JSON 格式化的错误消息和错误代码：
```
{    "error": {        "code": "40004",        "description": "transaction id is invalid"    }}
```

### 可能出现的错误​

在本主题中，您将按 HTTP 响应分类找到各端点可能出现的错误。
#### 交易创建​

HTTP 代码代码描述原因40040001error decoding json发送的数据与服务契约不匹配。40040002error validating json部分信息格式不正确或缺失。40040021invalid phone提供的电话号码无效，必须遵循格式：55 DDD NUMBER。例如：5543999999999。40040022invalid email提供的邮箱无效。40040027replicated transaction发送的交易已存在，无法再次创建。40040045max value reached交易金额超过允许的上限时。40340301not allowed用户没有权限执行此操作。40440404company not found提供的公司不存在。42940001too many requests达到速率限制。50050001internal error内部服务故障。
#### 获取交易状态​

HTTP 代码代码描述原因40040001error decoding json发送的数据与服务契约不匹配。40040002error validating json部分信息格式不正确或缺失。40040004transaction id is invalid交易 ID 无效（格式问题）。40040301not allowed用户没有权限执行此操作。42940401transaction not found未找到该交易。50050001internal error内部服务故障。
#### 获取交易证据集​

HTTP 代码代码描述原因40040004transaction id is invalid交易 ID 无效（格式问题）。40040009transaction status is invalid交易状态无效（不允许生成证据集）。40340301not allowed用户没有权限执行此操作。40440401transaction not found未找到该交易。50050001internal error内部服务故障。
#### 重新发送交易通知​

HTTP 代码代码描述原因40040001error decoding json发送的数据与服务契约不匹配。40040002error validating json部分信息格式不正确或未填写。40040004transaction id is invalid交易 ID 无效（格式问题）。40040009transaction status is invalid交易状态不允许重新发送通知（该交易已完成）。40040021invalid phone提供的电话号码无效，必须遵循格式：55 DDD NUMBER。例如：5543999999999。40040022invalid email提供的邮箱无效。40340301not allowed用户没有权限执行此操作。40440401transaction not found未找到该交易。42940001too many requests达到速率限制。50050001internal error达到速率限制。
#### 信用卡 Onboarding​

HTTP 代码代码描述原因40040001error decoding json发送的数据与服务契约不匹配。40040002error validating json部分信息格式不正确或缺失。40040027replicated transaction提交的交易已存在，无法再次创建。40040030invalid identity请求中提供的 CPF 与指定 `processID` 关联的 CPF 不一致。40040045max value reached当交易超过允许金额时。40040054processID is invalid当请求中提供的 `processID` 无效（或不存在）时。40040055processID is expired当所使用的 `processID` 过旧时。40340301not allowed用户没有权限执行此操作。40440404company not found指定的公司不存在。40440410processID not found当指定的流程不存在时。40440412image not found当用户指定的流程没有图片时。42940001too many requests达到速率限制。42942901too many requests当客户端发送的请求过多，超出预设限制时。50050001internal error内部服务故障。最后更新 于 2026年10月8日**