Support API Mobile2MetaVerifyIntl.

Author: sdk-team

ChangeLog.md

@@ -1,3 +1,7 @@
+2025-07-18 Version: 3.10.0
+- Support API Mobile2MetaVerifyIntl.
+
+
 2025-07-15 Version: 3.9.1
 - Update API DocOcrMax: add request parameters DocPage.
 

src/Cloudauthintl.php

@@ -45,6 +45,8 @@
 use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\InitializeResponse;
 use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\InitializeShrinkRequest;
 use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\KeepaliveIntlResponse;
+use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\Mobile2MetaVerifyIntlRequest;
+use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\Mobile2MetaVerifyIntlResponse;
 use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\Mobile3MetaVerifyIntlRequest;
 use AlibabaCloud\SDK\Cloudauthintl\V20220809\Models\Mobile3MetaVerifyIntlResponse;
 use AlibabaCloud\Tea\Exception\TeaError;
@@ -218,7 +220,9 @@ public function addressVerifyIntl($request)
     }
 
     /**
-     * @summary 银行卡核验
+     * @summary Bank Card Verification
+     *  *
+     * @description Verification of bank card elements, including: two-element verification (name + bank card number), three-element verification (name + ID number + bank card number), and four-element verification (name + ID number + phone number + bank card number) for consistency.
      *  *
      * @param BankMetaVerifyIntlRequest $request BankMetaVerifyIntlRequest
      * @param RuntimeOptions            $runtime runtime options for this request RuntimeOptions
@@ -275,7 +279,9 @@ public function bankMetaVerifyIntlWithOptions($request, $runtime)
     }
 
     /**
-     * @summary 银行卡核验
+     * @summary Bank Card Verification
+     *  *
+     * @description Verification of bank card elements, including: two-element verification (name + bank card number), three-element verification (name + ID number + bank card number), and four-element verification (name + ID number + phone number + bank card number) for consistency.
      *  *
      * @param BankMetaVerifyIntlRequest $request BankMetaVerifyIntlRequest
      *
@@ -1574,6 +1580,62 @@ public function keepaliveIntl()
         return $this->keepaliveIntlWithOptions($runtime);
     }
 
+    /**
+     * @summary 手机号二要素核验API
+     *  *
+     * @param Mobile2MetaVerifyIntlRequest $request Mobile2MetaVerifyIntlRequest
+     * @param RuntimeOptions               $runtime runtime options for this request RuntimeOptions
+     *
+     * @return Mobile2MetaVerifyIntlResponse Mobile2MetaVerifyIntlResponse
+     */
+    public function mobile2MetaVerifyIntlWithOptions($request, $runtime)
+    {
+        Utils::validateModel($request);
+        $body = [];
+        if (!Utils::isUnset($request->mobile)) {
+            $body['Mobile'] = $request->mobile;
+        }
+        if (!Utils::isUnset($request->paramType)) {
+            $body['ParamType'] = $request->paramType;
+        }
+        if (!Utils::isUnset($request->productCode)) {
+            $body['ProductCode'] = $request->productCode;
+        }
+        if (!Utils::isUnset($request->userName)) {
+            $body['UserName'] = $request->userName;
+        }
+        $req = new OpenApiRequest([
+            'body' => OpenApiUtilClient::parseToMap($body),
+        ]);
+        $params = new Params([
+            'action' => 'Mobile2MetaVerifyIntl',
+            'version' => '2022-08-09',
+            'protocol' => 'HTTPS',
+            'pathname' => '/',
+            'method' => 'POST',
+            'authType' => 'AK',
+            'style' => 'RPC',
+            'reqBodyType' => 'formData',
+            'bodyType' => 'json',
+        ]);
+
+        return Mobile2MetaVerifyIntlResponse::fromMap($this->callApi($params, $req, $runtime));
+    }
+
+    /**
+     * @summary 手机号二要素核验API
+     *  *
+     * @param Mobile2MetaVerifyIntlRequest $request Mobile2MetaVerifyIntlRequest
+     *
+     * @return Mobile2MetaVerifyIntlResponse Mobile2MetaVerifyIntlResponse
+     */
+    public function mobile2MetaVerifyIntl($request)
+    {
+        $runtime = new RuntimeOptions([]);
+
+        return $this->mobile2MetaVerifyIntlWithOptions($request, $runtime);
+    }
+
     /**
      * @summary 手机号三要素国际版接口
      *  *

src/Models/BankMetaVerifyIntlRequest.php

@@ -9,31 +9,78 @@
 class BankMetaVerifyIntlRequest extends Model
 {
     /**
-     * @description This parameter is required.
+     * @description Bank card number.
+     *
+     * - When paramType is set to normal, enter the plaintext bank card number.
+     * - When paramType is set to md5, enter the plaintext part of the card number except the last 6 digits, followed by the MD5 value of the last 6 digits (32-character lowercase).
+     *
+     * This parameter is required.
+     *
+     * @example ● 明文：12345678******
+     * ● 密文：
+     * 12345678f8ee21920e37807b43e7e912ab829b6e
      *
      * @var string
      */
     public $bankCard;
 
     /**
+     * @description ID number:
+     * - When paramType is normal: Enter the plaintext ID number.
+     * - When paramType is md5:
+     * - First 6 digits of the ID number (plaintext) + date of birth (ciphertext) + last 4 digits of the ID number (plaintext).
+     * - For other IDs, encrypt the last two digits with MD5.
+     *
+     * Important
+     * This field is required when ProductType is one of the following:
+     * - BANK_CARD_3_META
+     * - BANK_CARD_4_META
+     *
+     * @example ● 明文：429001********8211
+     * ● 密文：
+     * 42900132fa7bcd874161bea8ec8fd98f390ec98211
+     *
      * @var string
      */
     public $identifyNum;
 
     /**
+     * @description ID type (default to ID card if left empty, see the table below for other types).
+     *
      * @example 01
      *
      * @var string
      */
     public $identityType;
 
     /**
+     * @description Phone number:
+     * - When paramType is normal: Enter the plaintext phone number.
+     * - When paramType is md5: Enter the ciphertext phone number.
+     *
+     * Important
+     *
+     * - This field is required when ProductType = BANK_CARD_4_META.
+     *
+     * @example ● 明文：186****2055
+     * ● 密文：
+     * 849169cd3b20621c1c78bd61a11a4fc2
+     *
      * @var string
      */
     public $mobile;
 
     /**
-     * @description This parameter is required.
+     * @description Encryption method:
+     * - normal: no encryption
+     * - md5: md5 encryption
+     *
+     * Important:
+     *
+     * - All encrypted parameters should be in the form of a 32-character lowercase MD5 string.
+     * - The ciphertext generated by different MD5 tools may vary. If the interface works before encryption but not after, try changing the MD5 tool.
+     *
+     * This parameter is required.
      *
      * @example normal
      *
@@ -42,7 +89,9 @@ class BankMetaVerifyIntlRequest extends Model
     public $paramType;
 
     /**
-     * @description This parameter is required.
+     * @description Fixed value: BANK_CARD_N_META
+     *
+     * This parameter is required.
      *
      * @example BANK_CARD_N_META
      *
@@ -51,7 +100,13 @@ class BankMetaVerifyIntlRequest extends Model
     public $productCode;
 
     /**
-     * @description This parameter is required.
+     * @description Product type to call:
+     *
+     * - BANK_CARD_2_META: Bank card number + name verification.
+     * - BANK_CARD_3_META: Bank card number + name + ID number verification.
+     * - BANK_CARD_4_META: Bank card number + name + ID number + phone number verification.
+     *
+     * This parameter is required.
      *
      * @example BANK_CARD_4_META
      *
@@ -60,14 +115,23 @@ class BankMetaVerifyIntlRequest extends Model
     public $productType;
 
     /**
-     * @description This parameter is required.
+     * @description Name.
+     *
+     * - When paramType is set to normal, enter the plaintext name.
+     * - When paramType is set to md5, encrypt the first character of the name with MD5 (32-character lowercase MD5) and append the rest of the name in plaintext.
+     *
+     * This parameter is required.
+     *
+     * @example 张*
      *
      * @var string
      */
     public $userName;
 
     /**
-     * @description This parameter is required.
+     * @description VERIFY_BANK_CARD: Bank card authentication mode. This indicates whether the provided bank card number matches the user\\"s real name, ID number, and phone number.
+     *
+     * This parameter is required.
      *
      * @example VERIFY_BANK_CARD
      *

src/Models/BankMetaVerifyIntlResponseBody.php

@@ -10,27 +10,35 @@
 class BankMetaVerifyIntlResponseBody extends Model
 {
     /**
+     * @description Return code: 200 for success, others for failure.
+     *
      * @example 200
      *
      * @var string
      */
     public $code;
 
     /**
+     * @description Return message
+     *
      * @example success
      *
      * @var string
      */
     public $message;
 
     /**
+     * @description Request ID.
+     *
      * @example 4EB35****87EBA1
      *
      * @var string
      */
     public $requestId;
 
     /**
+     * @description Returned result information
+     *
      * @var resultObject
      */
     public $resultObject;

src/Models/BankMetaVerifyIntlResponseBody/resultObject.php

@@ -9,13 +9,44 @@
 class resultObject extends Model
 {
     /**
+     * @description Verification result code.
+     * - 1: Consistent (charged)
+     * - 2: Inconsistent (charged)
+     * - 3: No record found (not charged)
+     *
      * @example 1
      *
      * @var string
      */
     public $bizCode;
 
     /**
+     * @description Verification details:
+     *
+     * - **101**: Verification passed.
+     * - **201**: Authentication information does not match, cardholder information is incorrect.
+     * - **202**: Authentication information does not match, bank card has not been activated for authenticated payments.
+     * - **203**: Authentication information does not match, bank card has expired.
+     * - **204**: Authentication information does not match, bank card is a restricted card.
+     * - **205**: Authentication information does not match, this card has been confiscated.
+     * - **206**: Authentication information does not match, bank card is invalid.
+     * - **207**: Authentication information does not match, this card has no corresponding issuing bank.
+     * - **208**: Authentication information does not match, this card is uninitialized or dormant.
+     * - **209**: Authentication information does not match, this card is a cheating card or swallowed card.
+     * - **210**: Authentication information does not match, this card has been reported lost.
+     * - **211**: Authentication information does not match, password error limit exceeded.
+     * - **212**: Authentication information does not match, issuing bank does not support this transaction.
+     * - **213**: Authentication information does not match, card status is abnormal or card is invalid.
+     * - **214**: Authentication information does not match, no phone number reserved.
+     * - **215**: Authentication information does not match, entered password, expiration date, or CVN2 is incorrect.
+     * - **216**: Authentication information does not match, other card anomalies.
+     * - **301**: Unable to verify, bank card does not support this service.
+     * - **302**: Unable to verify, verification failed or bank refused verification, please contact the issuing bank.
+     * - **303**: Unable to verify, bank card does not currently support phone number verification.
+     * - **304**: Unable to verify, bank card number is incorrect.
+     * - **305**: Unable to verify, other reasons.
+     * - **306**: Unable to verify, verification attempt limit exceeded.
+     *
      * @example 101
      *
      * @var string