---
title: クレジットカードOnboarding
description: カード非提示認証のクレジットカードOnboarding機能において、クレジットカードを検証しその検証ステータスを確認するためのREST APIリファレンス。
canonical: https://developer.unico.io/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding
locale: ja
generated_by: markdown-export
---

- [/ja/](/ja/)
- 地域別ソリューション
- [カード非提示認証](/ja/dual-api/developers/regional-solutions/card-not-present-verification)
- [統合](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview)
- [API](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis)
- [API リファレンス](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference)
- クレジットカードOnboarding

**このページの内容# クレジットカードOnboarding

### はじめに​

APIリクエストはアクセストークンを使用して認証されます。有効なアクセストークンを含まないリクエストはすべてエラーを返します。詳しくは[認証](/ja/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`objectyesユーザーの本人確認情報。`identity.key`stringyesユーザー識別キーのタイプ。`identity.value`stringyesユーザー識別キーの値。`orderNumber`stringyesオンボーディングに関連付けられた番号。ポータル内のインデックスとして、また貴社のシステムとカード非提示認証間の外部キーとして使用されます。`company`stringyesUnicoから提供される、取引を担当する会社のID。`redirectUrl`stringno取引完了後にユーザーをリダイレクトするURL(WebではHTTPSのURL、ネイティブモバイルアプリではSchema URL)。`card`objectyes取引で使用されるカード情報。`card.binDigits`stringyesカードの最初の8桁。`card.lastDigits`stringyesカードの下4桁。`card.expirationDate`stringnoカードの有効期限。`card.name`stringyesカード名義人の氏名 — エンコーディングの問題や承認の問題を避けるため、正しいことを確認してください。`value`numberno保証される最大金額。`additionalInfo`objectno他のUnico IDCloudプラットフォーム製品の生体キャプチャを再利用する場合は`processID`を、この取引に対して[サイレント認証](/ja/developers/regional-solutions/card-not-present-verification/integration/silent-verification)を有効にする場合は`externalUserID`を含めてこのオブジェクトを送信してください。`additionalInfo.processID`stringnoIDCloudプラットフォームの参照プロセスID。`additionalInfo.externalUserID`stringnoデバイスメタデータ収集時にSDKの`externalUserId`で設定したものと同じ識別子。サイレント検証をトリガーする場合にのみ必須です — これがない場合、取引は通常どおり作成されますが、常に標準のビジュアルフローに従います。
危険`orderNumber`フィールドには、そのeコマースシステムにおける購入の**一意の**注文番号を入力する必要があります — 別の取引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のセットアップやタイミング要件を含む完全なフローについては、[サイレント認証](/ja/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`オプション。取引で本人確認情報の入れ替えが発生したかどうか。
考えられるすべてのステータスについては、[列挙値](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated)をご覧ください。パフォーマンスを最適化するため、このエンドポイントをポーリングする代わりにWebhookを実装してください。
エラーレスポンスについては、[エラー — クレジットカードOnboarding](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding)をご覧ください。最終更新 2026年10月8日**に