如何从发票 ID 获取 PayPal 交易 ID

Question

我与一个电子商务网站合作，该网站使用用 PHP 编写的 PayPal 结账组件。出于会计目的，我想使用 PayPal PHP SOAP API 检索一些附加信息。

我发现了如何使用交易 ID 和 GetTransactionDetails 对象访问交易：

// snip - include PayPal libraries and set up APIProfile object -

$trans_details =& PayPal::getType('GetTransactionDetailsRequestType');
$tran_id = $_GET['transactionID'];
$trans_details->setTransactionId($tran_id, 'iso-8859-1');
$caller =& PayPal::getCallerServices($profile);
$response = $caller->GetTransactionDetails($trans_details);
$paymentTransDetails = $response->getPaymentTransactionDetails();

// snip - work with transaction details -

但是，我需要增强这一点，以便我可以首先使用本地可用的发票 ID 找到 12 个字符的字符串交易 ID MySQL 数据库（PayPal 网站上的交易中也引用了该数据库）。

我想我必须使用 交易搜索 ，但我不知道如何使用 PHP SOAP API 来做到这一点。如何检索发票 ID 的交易 ID？

Answer 1

我深入研究了 API 文档并设法找到了答案。

// snip - include PayPal libraries and set up APIProfile object (variable: profile) - 

$trans_search =& PayPal::getType('TransactionSearchRequestType');

// 01/12/201 as an example date, we always need a start date for the API
$start_date_str = '01/12/2011'; 
$start_time = strtotime($start_date_str);
$iso_start = date('Y-m-d\T00:00:00\Z', $start_time);
$trans_search->setStartDate($iso_start, 'iso-8859-1');

$invoice_ID = '10942456';  // here we insert the invoice ID we know
$trans_search->setInvoiceID($invoice_ID);

$caller =& PayPal::getCallerServices($profile);

$response = $caller->TransactionSearch($trans_search); // execute search

$ptsr = $response->getPaymentTransactions();
$nrecs = sizeof($ptsr);
$ack = $response->getAck();

if( ($ack != ACK_SUCCESS) 
    && ($ack != ACK_SUCCESS_WITH_WARNING) ) 
    exit; // jump out on error

if($nrecs == 1){ // check whether we found only one transaction (as expected)
    $paymentTransaction = $ptsr[0];
    // we found our transaction ID
    $transID = $paymentTransaction->getTransactionID();  
}else{
    // invoice ID not unique?! :-(
    exit('Found multiple transactions: '. print_r($ptsr, true)); // jump out        
}

// snip - work with transaction ID - 

Answer 2

使用 TransactionSearch API 按发票编号查找交易非常简单。您所需要做的就是将 API 调用中的 INVNUM 参数发送到 PayPal。

例如（基于 PayPal 的 TransactionSearch PHP 示例代码）：

<?php

/** TransactionSearch NVP example; last modified 08MAY23.
 *
 *  Search your account history for transactions that meet the criteria you specify. 
*/

$environment = 'sandbox';    // or 'beta-sandbox' or 'live'

/**
 * Send HTTP POST Request
 *
 * @param    string    The API method name
 * @param    string    The POST Message fields in &name=value pair format
 * @return    array    Parsed HTTP Response body
 */
function PPHttpPost($methodName_, $nvpStr_) {
    global $environment;

    // Set up your API credentials, PayPal end point, and API version.
    $API_UserName = urlencode('xxxxxxxxxxxx');
    $API_Password = urlencode('yyyyyyyyy');
    $API_Signature = urlencode('zzzzzzzzzzzzzzzzzzzzzzz');
    $API_Endpoint = "https://api-3t.paypal.com/nvp";
    if("sandbox" === $environment || "beta-sandbox" === $environment) {
        $API_Endpoint = "https://api-3t.$environment.paypal.com/nvp";
    }
    $version = urlencode('84.0');

    // Set the curl parameters.
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $API_Endpoint);
    curl_setopt($ch, CURLOPT_VERBOSE, 1);

    // Turn off the server and peer verification (TrustManager Concept).
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);

    // Set the API operation, version, and API signature in the request.
    $nvpreq = "METHOD=$methodName_&VERSION=$version&PWD=$API_Password&USER=$API_UserName&SIGNATURE=$API_Signature$nvpStr_";

    // Set the request as a POST FIELD for curl.
    curl_setopt($ch, CURLOPT_POSTFIELDS, $nvpreq);

    // Get response from the server.
    $httpResponse = curl_exec($ch);

    if(!$httpResponse) {
        exit("$methodName_ failed: ".curl_error($ch).'('.curl_errno($ch).')');
    }

    // Extract the response details.
    $httpResponseAr = explode("&", $httpResponse);

    $httpParsedResponseAr = array();
    foreach ($httpResponseAr as $i => $value) {
        $tmpAr = explode("=", $value);
        if(sizeof($tmpAr) > 1) {
            $httpParsedResponseAr[$tmpAr[0]] = $tmpAr[1];
        }
    }

    if((0 == sizeof($httpParsedResponseAr)) || !array_key_exists('ACK', $httpParsedResponseAr)) {
        exit("Invalid HTTP Response for POST request($nvpreq) to $API_Endpoint.");
    }

    return $httpParsedResponseAr;
}

到这里一切都如常。示例的唯一更改如下：

// Set request-specific fields.
//$transactionID = urlencode('example_transaction_id');
$invoice = urlencode('1234');

// Add request-specific fields to the request string.
//$nvpStr = "&TRANSACTIONID=$transactionID";
$nvpStr = "&INVNUM=$invoice";

此处，通过设置适当的 STARTDATE：

// Set additional request-specific fields and add them to the request string.
$startDateStr = "01/01/2010";            // in 'mm/dd/ccyy' format
$endDateStr;            // in 'mm/dd/ccyy' format
if(isset($startDateStr)) {
   $start_time = strtotime($startDateStr);
   $iso_start = date('Y-m-d\T00:00:00\Z',  $start_time);
   $nvpStr .= "&STARTDATE=$iso_start";
  }

if(isset($endDateStr)&&$endDateStr!='') {
   $end_time = strtotime($endDateStr);
   $iso_end = date('Y-m-d\T24:00:00\Z', $end_time);
   $nvpStr .= "&ENDDATE=$iso_end";
}

// Execute the API operation; see the PPHttpPost function above.
$httpParsedResponseAr = PPHttpPost('TransactionSearch', $nvpStr);

此处，通过添加一个简单的 if 语句来触发是否返回完整的 TransactionSearch API 结果，或仅返回 PayPal 交易 ID (bla.php ？视图=最小）：

if($_GET['view'] != "minimal") {
if("SUCCESS" == strtoupper($httpParsedResponseAr["ACK"]) || "SUCCESSWITHWARNING" == strtoupper($httpParsedResponseAr["ACK"])) {
    echo('TransactionSearch Completed Successfully: '.print_r($httpParsedResponseAr, true));
} else  {
    echo('TransactionSearch failed: ' . print_r($httpParsedResponseAr, true));
}
}
else {
// Output only the TransactionID
echo $httpParsedResponseAr['L_TRANSACTIONID0'];
}


?>