错误

简介

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

一般规则如下：

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

无卡验证还会生成以 JSON 格式化的错误消息和错误代码：

{
    "error": {
        "code": "40004",
        "description": "transaction id is invalid"
    }
}

可能出现的错误

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

交易创建

HTTP 代码	代码	描述	原因
400	40001	error decoding json	发送的数据与服务契约不匹配。
400	40002	error validating json	部分信息格式不正确或缺失。
400	40021	invalid phone	提供的电话号码无效，必须遵循格式：55 DDD NUMBER。例如：5543999999999。
400	40022	invalid email	提供的邮箱无效。
400	40027	replicated transaction	发送的交易已存在，无法再次创建。
400	40045	max value reached	交易金额超过允许的上限时。
403	40301	not allowed	用户没有权限执行此操作。
404	40404	company not found	提供的公司不存在。
429	40001	too many requests	达到速率限制。
500	50001	internal error	内部服务故障。

获取交易状态

HTTP 代码	代码	描述	原因
400	40001	error decoding json	发送的数据与服务契约不匹配。
400	40002	error validating json	部分信息格式不正确或缺失。
400	40004	transaction id is invalid	交易 ID 无效（格式问题）。
400	40301	not allowed	用户没有权限执行此操作。
429	40401	transaction not found	未找到该交易。
500	50001	internal error	内部服务故障。

获取交易证据集

HTTP 代码	代码	描述	原因
400	40004	transaction id is invalid	交易 ID 无效（格式问题）。
400	40009	transaction status is invalid	交易状态无效（不允许生成证据集）。
403	40301	not allowed	用户没有权限执行此操作。
404	40401	transaction not found	未找到该交易。
500	50001	internal error	内部服务故障。

重新发送交易通知

HTTP 代码	代码	描述	原因
400	40001	error decoding json	发送的数据与服务契约不匹配。
400	40002	error validating json	部分信息格式不正确或未填写。
400	40004	transaction id is invalid	交易 ID 无效（格式问题）。
400	40009	transaction status is invalid	交易状态不允许重新发送通知（该交易已完成）。
400	40021	invalid phone	提供的电话号码无效，必须遵循格式：55 DDD NUMBER。例如：5543999999999。
400	40022	invalid email	提供的邮箱无效。
403	40301	not allowed	用户没有权限执行此操作。
404	40401	transaction not found	未找到该交易。
429	40001	too many requests	达到速率限制。
500	50001	internal error	达到速率限制。

信用卡入驻

HTTP 代码	代码	描述	原因
400	40001	error decoding json	发送的数据与服务契约不匹配。
400	40002	error validating json	部分信息格式不正确或缺失。
400	40027	replicated transaction	提交的交易已存在，无法再次创建。
400	40030	invalid identity	请求中提供的 CPF 与指定 processID 关联的 CPF 不一致。
400	40045	max value reached	当交易超过允许金额时。
400	40054	processID is invalid	当请求中提供的 processID 无效（或不存在）时。
400	40055	processID is expired	当所使用的 processID 过旧时。
403	40301	not allowed	用户没有权限执行此操作。
404	40404	company not found	指定的公司不存在。
404	40410	processID not found	当指定的流程不存在时。
404	40412	image not found	当用户指定的流程没有图片时。
429	40001	too many requests	达到速率限制。
429	42901	too many requests	当客户端发送的请求过多，超出预设限制时。
500	50001	internal error	内部服务故障。