すべてのプロダクト
Search
ドキュメントセンター

ID Verification:BANK_CARD_N_META

最終更新日:Jun 26, 2026

BankMetaVerifyIntl API を使用して、2要素、3要素、または4要素認証を通じて銀行カードの名義人の ID を検証します。

API の説明

  • API オペレーション: BankMetaVerifyIntl

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

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

  • 説明: 銀行カードの名義人情報を検証します。 サポートされている認証タイプは次のとおりです。

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

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

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

  • QPS 制限: 各 API には専用の QPS 制限があります。 詳細については、「ID Verification サーバー側 API の QPS 制限」をご参照ください。

  • エンドポイント:

    説明
    • 内部ネットワークアクセスのメリット: 内部ネットワークを使用すると、同じリージョン内の Alibaba Cloud サービス間でプライベートな通信が可能になります。 ご利用のアプリケーションサーバーも同じリージョンにある場合は、内部ネットワークエンドポイントを使用して ID Verification サービスにアクセスすると、より安全で安定した接続が確保できます。

    • 海外アクセスの最適化: 中国本土以外のネットワーク状況は複雑になる可能性があります。 遅延を減らし、リクエストの失敗を最小限に抑えるには、「サーバー側のネットワーク遅延の分析と最適化」のベストプラクティスに従って統合を最適化してください。

    中国 (香港)

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

    • 内部エンドポイント: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

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

説明

デバッグまたは統合を行う前に、「OpenAPI を使用したサーバー側 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

はい

銀行カード番号:

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

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

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

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

UserName

String

はい

名前:

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

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

  • 平文: Zhang San

  • 暗号文: 6499fc7409049355527ef6a2ba5706b8San

IdentityType

String

いいえ

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

01

IdentifyNum

String

いいえ

証明書番号:

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

  • ParamTypemd5 に設定されている場合:

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

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

重要

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

  • BANK_CARD_3_META

  • BANK_CARD_4_META

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

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

Mobile

String

いいえ

携帯電話番号:

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

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

重要

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

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

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

証明書タイプ一覧

IdentityType

証明書

01

ID カード

02

役員証明書

03

パスポート

04

香港・マカオ住民中国本土渡航許可証

05

台湾住民向け大陸渡航許可証

06

警察官証明書

07

軍人証明書

08

外国旅券

09

外国人永住者 ID カード

10

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

11

台湾住民居留許可証

12

通行許可証

13

出入国許可証

レスポンスパラメーター

名前

タイプ

説明

RequestId

String

リクエスト ID。

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

Code

String

リターンコード: 詳細については、「サーバー側の HTTP ステータスコード」をご参照ください。

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