iTransact：如何創建腳本來更改/取消用戶訂閱

Question

如何創建HTML表單以允許用戶更改其iTransact（itransact.com）訂閱設置？

例如：1）停止使用自動續訂的：

• 形式需要在 'recur_reps' 值更改爲0

例如：2）改變他們的訂閱類型：

• 形式需要改變 'recur_total' 和 'recur_desc'

01的值

（即：發佈表單的網址是什麼以及我需要發佈哪些表單域？）

Answer 1

根據iTransact支持技術人員，無法創建HTML表單以允許用戶更改他們的iTransact（itransact.com）訂閱設置。但是，有一個XML API可以完成這項工作。

由於向iTransact的XML API發送XML請求的代碼並不簡單直觀，因此我決定將一個工作示例程序發佈到Stack Overflow上，因爲它可能對其他人有用，特別是因爲它們沒有示例喜歡它在iTransact.com文檔中。

以下示例程序發送請求以獲取現有事務的詳細信息。

<?php 

define('ITRANSACT_API_UPDATE_URL', 'https://secure.itransact.com/cgi-bin/rc/xmltrans2.cgi'); 
define('ITRANSACT_API_GATEWAY', '12345'); // vendor account number 
define('ITRANSACT_API_USERNAME', 'fdfsdfksafdsafdsafdsafdsafdsa'); // vendor API username 
define('ITRANSACT_API_KEY', 'fdsfdsafdsafdsfdsfdsfds'); // vendor API key 

/** 
* iTransact's XML API requires us to encrypt the XML command with a 
* special key known only to us and iTransact. This is to ensure that the 
* request cannot be modified after leaving our server. 
* 
* A keyed hash value is generated using the HMAC-SHA1 algorithm and then 
* encoded with base-64 MIME. 
* 
* @param string $strXMLCmd: xml for the command operation 
* 
* @returns string: the base64-encrypted HASH_SHA1 payload Signature 
*     for the command 
*/ 
function getITransactPayloadSignagureForCommand($strXMLCmd){ 

    $key = ITRANSACT_API_KEY; 

    #Using built in PHP5 functions: 
    $digest = hash_hmac('sha1', $strXMLCmd, $key, true); 
    $strPayLoadSignature = base64_encode($digest); 

    #Using PEAR module: 
    #require_once 'Crypt/HMAC.php'; 
    #$hmac = new Crypt_HMAC($key,"sha1"); 
    #$digest = pack("H40", $hmac->hash(trim($payload))); 
    #$actual_signature = base64_encode($digest); 

    return $strPayLoadSignature; 
} 

/** 
* Constructs the XML request in the iTransact format for the request 
* including login credentials 
* 
* @param string $strXMLCmd: specific xml for the operation command 
*/ 
function construct_itransact_xml($strXMLCmd){ 

    $strPayLoadSignature = getITransactPayloadSignagureForCommand($strXMLCmd); 

    $strXML = '<?xml version="1.0"?>'; 
    $strXML .= '<GatewayInterface>'; 

    // Login credentials: 

    $strXML .= '<APICredentials>'; 
    $strXML .=  '<Username>'.ITRANSACT_API_USERNAME.'</Username>'; 
    $strXML .=  '<PayloadSignature>'.$strPayLoadSignature.'</PayloadSignature>'; 
    $strXML .=  '<TargetGateway>'.ITRANSACT_API_GATEWAY.'</TargetGateway>'; 
    $strXML .= '</APICredentials>'; 

    $strXML .= $strXMLCmd; // Unique part of every command 

    $strXML .= '</GatewayInterface>'; 

    return $strXML; 
} 

/** 
* Sends an XML request to iTransact. 
* 
* @param string $xml: the XML to send to iTransact 
* 
* @returns string: the XML responde from iTransact 
*/ 
function post_xml_to_iTransact($xml) { 

    $url = ITRANSACT_API_UPDATE_URL; 

    $ch = curl_init(); 

    curl_setopt($ch, CURLOPT_URL, $url); 
    curl_setopt($ch, CURLOPT_HEADER, true); 
    curl_setopt($ch, CURLINFO_HEADER_OUT, true); 
    curl_setopt($ch, CURLOPT_HTTPHEADER, Array("Content-Type: text/xml; charset=utf-8")); 
    curl_setopt($ch, CURLOPT_POST, 0); 
    curl_setopt($ch, CURLOPT_POSTFIELDS, $xml); 
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); 
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); 

    $result = curl_exec($ch); 
    $info = curl_getinfo($ch); 

    curl_close($ch); 

    return $result; 
} 

// *** MAIN *** 

// construct XML command: 

$strXID = '12345'; // transaction_id we wish to get details of 
$strXMLCmd = '<RecurDetails><OperationXID>'.$strXID.'</OperationXID></RecurDetails>'; // command we wish to send 
$strXML = construct_itransact_xml($strXMLCmd); 

// send XML command: 

$strReturnedXML = post_xml_to_iTransact($strXML); // send request and fetch result 
echo 'Response XML from iTransact: '.var_export(htmlspecialchars($strReturnedXML), TRUE); 

?> 

注：請求更新/取消現有定期訂閱也會產生類似的格式，但將使用「recurUpdate」命令而不是「recurDetails」命令（對所有可能的命令的全部詳細信息，請參閱：http://www.itransact.com/downloads/PCDeveloperGuide.pdf）