すべてのプロダクト
Search

このプロダクト

    ID Verification:BANK_CARD_N_META

    ドキュメントセンター

    ID Verification:BANK_CARD_N_META

    最終更新日:Nov 09, 2025

    このトピックでは、2 要素、3 要素、および 4 要素の銀行カード検証の API 操作について説明します。

    API の説明

    • API 操作: BankMetaVerifyIntl

    • リクエストメソッド: POST および GET

    • トランスポートプロトコル: HTTPS

    • 説明: 銀行カード要素の一貫性を検証します。これには以下が含まれます。

      • 2 要素銀行カード検証 (銀行カード番号 + 氏名)

      • 3 要素銀行カード検証 (銀行カード番号 + 氏名 + 証明書番号)

      • 4 要素銀行カード検証 (銀行カード番号 + 氏名 + 証明書番号 + 携帯電話番号)

    • QPS 制限: この API は、排他的な 1 秒あたりのクエリ数 (QPS) 制限の対象となります。詳細については、「ID Verification サーバーサイド API の QPS 制限」をご参照ください。

    • エンドポイント:

      説明

      内部ネットワークは、同じリージョン内の Alibaba Cloud プロダクト間のプライベート通信ネットワークです。アプリケーションサーバーが Alibaba Cloud リージョンにデプロイされている場合、内部エンドポイントを使用して ID Verification サービスにアクセスできます。これにより、より安全で安定したネットワーク接続が提供されます。

      中国 (香港)

      • パブリックエンドポイント: cloudauth-intl.cn-hongkong.aliyuncs.com

      • 同一リージョン内の内部エンドポイント: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    オンラインでのデバッグと統合

    説明

    デバッグと統合を行う前に、「OpenAPI Explorer を使用してサーバーサイド API 操作をデバッグおよび統合する」ドキュメントをお読みください。このドキュメントでは、OpenAPI プラットフォームで API 操作を呼び出す方法と、SDK およびそのサンプルコードを取得する方法について説明しています。

    この API 操作は OpenAPI Explorer でデバッグできます。また、この API 操作用の サンプル SDK コードを生成することもできます。

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    例

    ProductCode

    String

    はい

    静的フィールド: BANK_CARD_N_META

    BANK_CARD_N_META

    ParamType

    String

    はい

    暗号化メソッド:

    • normal: プレーンテキストは暗号化されません。

    • md5: MD5 暗号化。

    重要

    • すべてのパラメーターの暗号文は、32 ビットの小文字の MD5 文字列である必要があります。

    • MD5 ツールが異なると、生成される暗号文も異なる場合があります。暗号化前に API 呼び出しが機能し、暗号化後に失敗する場合は、別の MD5 ツールを試してください。

    normal

    VerifyMode

    String

    はい

    VERIFY_BANK_CARD: 銀行カード認証モード。

    このモードは、提供された銀行カード番号がユーザーの実名、証明書番号、および携帯電話番号と一致するかどうかを確認します。

    VERIFY_BANK_CARD

    ProductType

    String

    はい

    呼び出すプロダクトタイプ:

    • BANK_CARD_2_META: 銀行カード番号と氏名を検証します。

    • BANK_CARD_3_META: 銀行カード番号、氏名、証明書番号を検証します。

    • BANK_CARD_4_META: 銀行カード番号、氏名、証明書番号、携帯電話番号を検証します。

    BANK_CARD_4_META

    BankCard

    String

    はい

    銀行カード番号:

    • ParamType が normal に設定されている場合は、銀行カード番号のプレーンテキストを入力します。

    • ParamType が md5 に設定されている場合は、銀行カード番号の最後の 6 桁を除くプレーンテキストを入力し、その後に最後の 6 桁の暗号文を入力します。

    • プレーンテキスト: 12345678******

    • 暗号文: 12345678f8ee21920e37807b43e7e912ab******

    UserName

    String

    はい

    氏名:

    • ParamType が normal に設定されている場合は、氏名のプレーンテキストを入力します。

    • ParamType が md5 に設定されている場合は、氏名の最初の文字の暗号文を入力し、その後に氏名の残りの部分のプレーンテキストを入力します。

    • プレーンテキスト: Zhang San

    • 暗号文: 6499fc7409049355527ef6a2ba5706b8San

    IdentityType

    String

    いいえ

    証明書タイプ。このパラメーターを空のままにすると、デフォルトで ID カードになります。その他の証明書タイプについては、「証明書タイプ一覧」をご参照ください。

    01

    IdentifyNum

    String

    いいえ

    証明書番号:

    • ParamType が normal に設定されている場合は、証明書番号のプレーンテキストを入力します。

    • ParamType が md5 に設定されている場合:

      • ID カード番号の場合、最初の 6 桁のプレーンテキスト、生年月日の暗号文、最後の 4 桁のプレーンテキストの順に入力します。

      • その他の証明書タイプの場合、最後の 2 桁を MD5 を使用して暗号化します。

    重要

    このパラメーターは、ProductType が次のいずれかの値に設定されている場合に必須です。

    • BANK_CARD_3_META

    • BANK_CARD_4_META

    • プレーンテキスト: 429001********8211

    • 暗号文: 42900132fa7bcd874161bea8ec8fd98f******8211

    Mobile

    String

    いいえ

    携帯電話番号:

    • ParamType が normal に設定されている場合は、携帯電話番号のプレーンテキストを入力します。

    • ParamType が md5 に設定されている場合は、携帯電話番号の暗号文を入力します。

    重要

    このパラメーターは、ProductType が BANK_CARD_4_META に設定されている場合に必須です。

    • プレーンテキスト: 186****2055

    • 暗号文: 849169cd3b20621c1c78bd61a1******

    証明書タイプ一覧

    IdentityType

    証明書

    01

    ID カード

    02

    将校証明書

    03

    パスポート

    04

    香港・マカオ住民内地通行証

    05

    台湾住民内地通行証

    06

    警察官証明書

    07

    兵士証明書

    08

    外国パスポート

    09

    外国人永久居留身分証

    10

    香港・マカオ住民居留許可証

    11

    台湾住民居留許可証

    12

    旅行許可証

    13

    出入境許可証

    応答パラメーター

    名前

    タイプ

    説明

    例

    RequestId

    String

    リクエスト ID。

    130A2C10-B9EE-4D84-88E3-5384FF******

    Code

    String

    応答コード。

    Success

    Message

    String

    応答コードの詳細な説明。

    success

    ResultObject

    BizCode

    String

    検証結果:

    • 1: 一致 (課金対象)

    • 2: 不一致 (課金対象)

    • 3: レコードが見つかりません (課金対象外)

    1

    SubCode

    String

    検証の詳細:

    • 101: 検証に合格しました。

    • 201: 認証情報が不一致です。カードの名義人情報が正しくありません。

    • 202: 認証情報が不一致です。銀行カードで認証済み支払いが有効になっていません。

    • 203: 認証情報が不一致です。銀行カードの有効期限が切れています。

    • 204: 認証情報が不一致です。銀行カードは制限されています。

    • 205: 認証情報が不一致です。このカードは没収されました。

    • 206: 認証情報が不一致です。銀行カードは無効です。

    • 207: 認証情報が不一致です。このカードに対応する発行銀行がありません。

    • 208: 認証情報が不一致です。カードが初期化されていないか、休眠状態です。

    • 209: 認証情報が不一致です。このカードは不正なカードであるか、保持されています。

    • 210: 認証情報が不一致です。このカードは紛失届が出されています。

    • 211: 認証情報が不一致です。パスワードの誤入力回数が制限を超えました。

    • 212: 認証情報が不一致です。発行銀行はこの取引をサポートしていません。

    • 213: 認証情報が不一致です。カードのステータスが異常であるか、カードが無効です。

    • 214: 認証情報が不一致です。携帯電話番号が予約されていません。

    • 215: 認証情報が不一致です。入力されたパスワード、有効期限、または CVN2 が正しくありません。

    • 216: 認証情報が不一致です。その他のカード例外。

    • 301: 検証に失敗しました。銀行カードはこのサービスをサポートしていません。

    • 302: 検証に失敗しました。検証が失敗したか、銀行によって拒否されました。発行銀行にお問い合わせください。

    • 303: 検証に失敗しました。銀行カードは現在、携帯電話番号の検証をサポートしていません。

    • 304: 検証に失敗しました。銀行カード番号が正しくありません。

    • 305: 検証に失敗しました。その他の理由。

    • 306: 検証に失敗しました。検証試行回数が制限を超えました。

    101

    応答コード

    HTTP ステータスコード

    コード

    メッセージの説明

    200

    Success

    リクエストは成功しました。

    400

    MissingParameter

    必須パラメーターがありません。

    InvalidParameter

    パラメーターが無効です。

    403

    Forbidden.RAMUserAccessDenied

    リソースアクセス管理 (RAM) ユーザーには AliyunAntCloudAuthFullAccess 権限がありません。詳細については、「RAM ユーザーにサービスへのアクセス権限を付与する」をご参照ください。

    Forbidden.AccountAccessDenied

    ID Verification を有効にし、アカウントに支払い遅延がないことを確認してください。

    Throttling.Api

    API 呼び出しはスロットリングによってブロックされています。

    500

    InternalError

    内部エラーが発生しました。テクニカルサポートにお問い合わせください。