--- title: 決済取引 description: カード非提示認証における決済取引の作成、ステータスの確認、証跡の取得、通知の再送信を行うためのREST APIリファレンス。 canonical: https://developer.unico.io/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions 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) - 決済取引 **このページの内容# 決済取引 ### はじめに​ 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` ### 取引の作成​ `POST /credit/transaction` — 新しい取引を作成します。 危険コンバージョンを高めるため、事前認証やカード非提示認証体験の前に取引を完了させてしまう可能性のある検証は、すべて完了させた**後にのみ**取引を作成してください。 危険`orderNumber`フィールドには、そのeコマースシステムにおける購入の**一意の**注文番号を入力する必要があります — 別の取引IDを使用するのは誤りです。これを使い回すと、コンバージョンの低下(注文番号はエンドユーザーがフローを完了する助けとなります)や、同じ注文番号・CPF・BIN・下4桁を使用した場合の`replicated transaction`のようなAPIエラーの原因となる可能性があります。 ヘッダー ヘッダー値`Authorization``Bearer {token}` — 有効なアクセストークン。 ボディ ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "order-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/checkout/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 199.90, "mainContacts": [ { "key": "phone", "value": "5543999999999" } ], "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` フィールド型必須説明`identity`objectyesユーザー識別データ。`identity.key`stringyesユーザー識別キーのタイプ。`cpf`を推奨します — コンバージョン率が高くなります。`identity.value`stringyesユーザー識別キーの値。ドットやハイフンを含めないこと。`orderNumber`stringyes取引に関連付けられた注文番号。ポータル内のインデックスとして、また貴社のシステムとカード非提示認証間の外部キーとして使用されます。`company`stringyesUnicoから提供される、取引を担当する会社のID。`redirectUrl`stringno取引完了後にユーザーをリダイレクトするURL(WebではHTTPSのURL、ネイティブモバイルアプリではURLスキーム)。`card`objectyes取引で使用されるカードに関する情報。`card.binDigits`stringyesカードの最初の8桁。`card.lastDigits`stringyesカードの下4桁。`card.expirationDate`stringnoカードの有効期限。`card.name`stringyesカード名義人の氏名。ユーザー体験やコミュニケーションで使用されるため、エンコーディングの問題を避け、正しく送信してください。`value`numberyes購入の合計金額。`mainContacts`arraynoカード非提示認証が通知を担当する場合に、ユーザーへの通知に使用される主な連絡先(メールおよび/または電話)のリスト。`fallbackContacts`arrayno主な連絡先への通知試行が失敗した場合にトリガーされる、代替連絡先のリスト。`additionalInfo`objectnoこの取引で[サイレント認証](/ja/developers/regional-solutions/card-not-present-verification/integration/silent-verification)を有効にするには、`externalUserID`を含むこのオブジェクトを送信してください。`additionalInfo.externalUserID`stringyes(`additionalInfo`を送信する場合)デバイスメタデータの収集時にSDKの`externalUserId`で設定したものと同じ識別子。サイレント検証をトリガーするために必須です — これを指定しない場合、取引は通常どおり作成されますが、常に標準の画面表示フローに従います。 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...", "expiresAt": "2026-07-22T15:30:00Z"} ``` フィールド説明`id`作成された取引のID。`status`取引の現在のステータス。`link`取引に関連するリンク。`token`カード非提示認証 Web SDKを初期化するために必要なパラメーターを含む署名済みトークン。`expiresAt`取引の有効期限日時、ISO 8601(UTC)。 警告生体キャプチャが不要であると検証が判断した場合、レスポンスは異なるステータスとなり、キャプチャリンクは生成されません。``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "fast-inconclusive"} ``` これは、チェックアウトでPreまたはSuper Preモジュールを使用している場合に発生します。詳しくは[機能](/ja/developers/regional-solutions/card-not-present-verification/about-idpay/feature)をご覧ください。 メモ`additionalInfo.externalUserID`が送信され、取引がサイレントに承認された場合、レスポンスでもキャプチャリンクは省略されます。``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` SDKの設定やタイミング要件を含む完全なフローについては、[サイレント認証](/ja/developers/regional-solutions/card-not-present-verification/integration/silent-verification)をご覧ください。 エラーレスポンスについては、[エラー — 取引の作成](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#transaction-creation)をご覧ください。 ### 取引ステータスの取得​ `GET /credit/transactions/{transaction_id}` — 特定の取引の現在のステータスを確認します。 ヘッダー ヘッダー値`Authorization``Bearer {token}` — 有効なアクセストークン。 200 OK ``` { "status": "processing"} ``` フィールド説明`status`取引の現在のステータス。 考えられるすべてのステータスについては、[列挙値](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated)をご覧ください。パフォーマンスを最適化するため、このエンドポイントをポーリングする代わりにWebhookを実装してください。 エラーレスポンスについては、[エラー — 取引ステータスの取得](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#get-transaction-status)をご覧ください。 ### 取引の証跡セットの取得​ `GET /credit/transactions/{transaction_id}/probative` — 特定の取引の証跡セットを取得します。 警告証跡セットは、**承認済み**の取引に対してのみ生成できます。 危険証跡セット用に返されるリンクは、取得後**5分間**のみ有効です — 保存せず、すぐに証跡セットのダウンロードに使用してください。 ヘッダー ヘッダー値`Authorization``Bearer {token}` — 有効なアクセストークン。 200 OK ``` { "link": "https://unico.io/probative.pdf"} ``` フィールド説明`link`証跡ファイルのURL。 エラーレスポンスについては、[エラー — 取引の証跡セットの取得](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#recovery-of-the-evidentiary-set-of-the-transaction)をご覧ください。 ### 取引通知の再送信​ `POST /credit/transactions/{transaction_id}/notify` — 特定の取引についてメールおよび/または電話による通知を再送信します。 メモAPIを実装せずに、ポータルから通知の再送信を設定することも可能です。可能性についてはプロジェクトの担当窓口にご相談ください。 ヘッダー ヘッダー値`Authorization``Bearer {token}` — 有効なアクセストークン。 ボディ ``` { "phone": "NOTIFICATION_PHONE", "email": "NOTIFICATION_EMAIL"} ``` フィールド型必須説明`phone`stringyes通知を送信する電話番号。`email`stringyes通知を送信するメールアドレス。 200 OK ``` { "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240", "link": "https://aces.so/example"} ``` フィールド説明`id`生成された通知の一意のID。`link`生成された通知用のリンク。 エラーレスポンスについては、[エラー — 取引通知の再送信](/ja/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#resending-the-transaction-notification)をご覧ください。最終更新 2026年10月8日**に