---
title: 信用卡 Onboarding
description: 无卡验证信用卡 Onboarding 功能中用于验证信用卡并查询验证状态的 REST API 参考。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding
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)
- [API 参考](/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference)
- 信用卡 Onboarding

**本页内容# 信用卡 Onboarding

### 开始之前​

您的 API 请求使用访问令牌进行身份验证。任何不包含有效访问令牌的请求都将返回错误。在[身份验证](/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication)中了解更多信息。
基础 URL
**UAT**：`https://transactions.transactional.uat.unico.app/api/public/v1`
**生产环境**：`https://transactions.transactional.unico.app/api/public/v1`

重要信用卡 Onboarding既可以通过向终端用户请求自拍照并完成完整注册来执行，**也**可以通过复用其他 Unico IDCloud 平台产品所执行流程中的生 物识别捕获来完成：
若要复用其他 IDCloud 产品生成的流程，请在 `additionalInfo.processID` 中提供参考流程 ID；
所使用的参考流程必须是在不超过 **1 小时**之前完成的。

### 验证信用卡​

`POST /walletid/transaction` — 验证一张信用卡。
请求头
请求头值`Authorization``Bearer {token}` — 一个有效的访问令牌。
请求体
```
{  "identity": { "key": "cpf", "value": "12345678900" },  "orderNumber": "onboarding-98765",  "company": "company-id",  "redirectUrl": "https://yourapp.com/wallet/return",  "card": {    "binDigits": "12345678",    "lastDigits": "1234",    "expirationDate": "12/2028",    "name": "John Doe"  },  "value": 5000.00,  "additionalInfo": {    "externalUserID": "YOUR_EXTERNAL_USER_ID"  }}
```

字段类型是否必填描述`identity`object是用户身份信息。`identity.key`string是用户识别键的类型。`identity.value`string是 用户识别键的值。`orderNumber`string是与该入驻流程关联的编号。用作门户中的索引，以及您的系统与无卡验证之间的外键。`company`string是负责该交易的公司 ID，由 Unico 提供。`redirectUrl`string否交易完成后用户被重定向到的 URL（Web 端为 HTTPS URL，原生移动应用为 Schema URL）。`card`object是交易中所用的卡片信息。`card.binDigits`string是卡片的前 8 位数字。`card.lastDigits`string是卡片的末 4 位数字。`card.expirationDate`string否卡片的到期日期。`card.name`string是持卡人姓名——请确保其正确，以避免编码问题或审批问题。`value`number否最高担保金额。`additionalInfo`object否发送此对象及 `processID`，以复用其他 Unico IDCloud 平台产品的生物识别捕获；和/或发送 `externalUserID`，为此交易启用[静默验证](/zh-CN/developers/regional-solutions/card-not-present-verification/integration/silent-verification)。`additionalInfo.processID`string否来自 IDCloud 平台的参考流程 ID。`additionalInfo.externalUserID`string否与在采集设备元数据时通过 SDK 的 `externalUserId` 配置的标识符相同。仅在需要触发静默验证时才是必需的——如果缺失，交易仍会正常创建，但始终遵循标准可视 化流程。
危险`orderNumber` 字段必须填写该笔购买在电商系统中**唯一**的订单编号——使用不同的交易 ID 是不正确的做法，重复使用该值可能触发 `replicated transaction` 错误。
200 OK
```
{  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",  "status": "processing",  "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481",  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}
```

字段描述`id`已创建交易的 ID。`status`交易当前状态。`link`与该交易相关的链接。仅当**未**提供 `additionalInfo.processID` 时才会返回。`token`用于初始化无卡验证 Web SDK 的已签名令牌。仅当**未**提供 `additionalInfo.processID` 时才会返回。
备注如果发送了 `additionalInfo.externalUserID` 且交易被静默批准，响应中也会省略捕获链接：```
{    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",    "status": "approved"}
```

完整流程（包括 SDK 设置和时间要求）请参见[静默验证](/zh-CN/developers/regional-solutions/card-not-present-verification/integration/silent-verification)。
### 查询验证状态​

`GET /walletid/transactions/{transaction_id}` — 查询指定交易的当 前状态。
请求头
请求头值`Authorization``Bearer {token}` — 一个有效的访问令牌。
200 OK
```
{  "status": "processing",  "hasIdentityChanged": false}
```

字段描述`status`交易的当前状态。`hasIdentityChanged`可选。该交易中是否发生了身份调换。
有关所有可能的状态，请参阅[枚举](/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated)。为优化性能，建议实现 Webhook，而非轮询此端点。
有关错误响应，请参阅[错误 — 信用卡 Onboarding](/zh-CN/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding)。最后更新 于 2026年10月8日**