PHP WHMCS UpdatePayMethod用法及代碼示例

更新信用卡支付方式。

請求參數

參數	類型	說明	必需的
action	string	“UpdatePayMethod”	Required
clientid	int	匹配支付方式的客戶id	Required
paymethodid	int	要更新的付款方式的 ID	Required
card_number	string	信用卡號碼。為CreditCard 或RemoteCreditCard 支付方式更新的卡號。可選的。僅在您希望進行更新時提供	Optional
card_expiry	string	CreditCard 或 RemoteCreditCard 付款方式的更新到期日期。格式“MMYY”，例如 0122。可選。僅在您希望進行更新時提供	Optional
card_start	string	CreditCard 或 RemoteCreditCard 付款方式的更新開始日期。格式“MMYY”‘eg’0122。可選。僅在您希望進行更新時提供	Optional
card_issue_number	int	issue_number 更新為 CreditCard 或 RemoteCreditCard 支付方式。可選的。僅在您希望進行更新時提供	Optional
bank_name	string	銀行名稱。可選的。僅在您希望進行更新時提供	Optional
bank_account_type	string	銀行賬戶的類型(支票、信用等)。可選的。僅在您希望進行更新時提供	Optional
bank_code	string	銀行代碼。也稱為排序代碼或路由編號。可選的。僅在您希望進行更新時提供	Optional
bank_account	string	帳號。 BankAccount 類型是必需的。可選的。僅在您希望進行更新時提供	Optional
set_as_default	bool	新的付款方式是否應為客戶默認設置	Optional

響應參數

參數	類型	說明
result	string	操作結果：成功或錯誤
paymethodid	int	更新後的支付方式的 id
clientid	int	客戶的id

示例請求 (CURL)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.example.com/includes/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,
    http_build_query(
        array(
            'action' => 'UpdatePayMethod',
            // See https://developers.whmcs.com/api/authentication
            'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
            'password' => 'SECRET_OR_HASHED_PASSWORD',
            'paymethodid' => '1',
            'clientid' => '1',
            'card_expiry' => '1025',
            'responsetype' => 'json',
        )
    )
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);

示例請求(本地 API)

$command = 'UpdatePayMethod';
$postData = array(
    'paymethodid' => '1',
    'clientid' => '1',
    'card_expiry' => '1025',
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later

$results = localAPI($command, $postData, $adminUsername);
print_r($results);

示例響應 JSON

{
    "result": "success",
    "clientid": "1",
    "paymethodid": "1"
}

錯誤響應

可能的錯誤條件響應包括：

• 付款方式 ID 為必填項
• 客戶 ID 為必填項
• 付款方式 ID 無效
• 支付方式不屬於傳遞的客戶ID
• 不支持更新的網關類型
• 沒有提供更新的詳細信息
• 無法更新輔助網關的卡號
• 到期日無效
• 開始日期無效
• 發行號無效
• 更新遠程支付方式時出錯：xxx(來自網關的消息)