(PHP ActiveX) Payeezy Place Temp Authorization Hold on Buyer’s Credit Card

Demonstrates how to place a temporary authorization hold for the desired amount on the buyer’s credit card. You can Capture the authorized amount on completion of service or Void/Refund the transaction as required.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows Note: The php_com_dotnet.dll may need to be enabled inside of php.ini.

<?php

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Crypt2')
$crypt = new COM("Chilkat.Crypt2");
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Prng')
$prng = new COM("Chilkat.Prng");

// An API key such as y6pWAJNyJyjGv66IsVuWnklkKUPFbb0a
$apiKey = 'my_api_key';
// An API secret such as 86fbae7030253af3cd15faef2a1f4b67353e41fb6799f576b5093ae52901e6f7
$apiSecret = 'my_api_secret';
// A token such as fdoa-a480ce8951daa73262734cf102641994c1e55e7cdf4c02b6
$token = 'my_merchant_token';

// The nonce is a random number (bytes), something like "6057786719490086000"
$nonce = $prng->genRandom(8,'decimal');
print 'nonce = ' . $nonce . "\n";

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.CkDateTime')
$dtNow = new COM("Chilkat.CkDateTime");
$dtNow->SetFromCurrentSystemTime();
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbTimestamp = new COM("Chilkat.StringBuilder");
// Get the epoch timestamp in seconds
$sbTimestamp->Append($dtNow->getAsUnixTimeStr(0));
// Change it to milliseconds
$sbTimestamp->Append('000');
// The timestamp is a number similar to this: 1546011905000 (which is a timestamp taken on 28-Dec-2018).
$timestamp = $sbTimestamp->getAsString();
print 'timestamp = ' . $timestamp . "\n";

// Generate the following JSON request body:
// {
//   "merchant_ref": "Astonishing-Sale",
//   "transaction_type": "authorize",
//   "method": "credit_card",
//   "amount": "1299",
//   "currency_code": "USD",
//   "credit_card": {
//     "type": "visa",
//     "cardholder_name": "John Smith",
//     "card_number": "4788250000028291",
//     "exp_date": "1020",
//     "cvv": "123"
//   }
// }

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$json = new COM("Chilkat.JsonObject");
$json->UpdateString('merchant_ref','Astonishing-Sale');
$json->UpdateString('transaction_type','authorize');
$json->UpdateString('method','credit_card');
$json->UpdateString('amount','1299');
$json->UpdateString('currency_code','USD');
$json->UpdateString('credit_card.type','visa');
$json->UpdateString('credit_card.cardholder_name','John Smith');
$json->UpdateString('credit_card.card_number','4788250000028291');
$json->UpdateString('credit_card.exp_date','1020');
$json->UpdateString('credit_card.cvv','123');
$json->EmitCompact = 0;
print $json->emit() . "\n";

// string hashData = apiKey + nonce + timestamp + token + jsonString;
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbHmacData = new COM("Chilkat.StringBuilder");
$sbHmacData->Append($apiKey);
$sbHmacData->Append($nonce);
$sbHmacData->Append($timestamp);
$sbHmacData->Append($token);
$sbHmacData->Append($json->emit());

// HMAC the data to produce a hex string.
$crypt->EncodingMode = 'hexlower';
$crypt->MacAlgorithm = 'hmac';
$crypt->SetMacKeyString($apiSecret);
$crypt->HashAlgorithm = 'sha256';
$crypt->Charset = 'utf-8';
$hexHash = $crypt->macStringENC($sbHmacData->getAsString());
print 'hexHash = ' . $hexHash . "\n";

// Now base64 encode the hex string:
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbBase64Hash = new COM("Chilkat.StringBuilder");
$sbBase64Hash->Append($hexHash);
$sbBase64Hash->Encode('base64','utf-8');

print 'This is the Authorization header to be sent with the payeezy request:' . "\n";
print 'Authorization: ' . $sbBase64Hash->getAsString() . "\n";

// -----------------------------------------------------------
// Now that we have the value for the Authorization header, send the POST containing the JSON.

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Http')
$http = new COM("Chilkat.Http");

$http->Accept = '*/*';
$http->UserAgent = '';
$http->SetRequestHeader('Authorization',$sbBase64Hash->getAsString());
$http->SetRequestHeader('apikey',$apiKey);
$http->SetRequestHeader('nonce',$nonce);
$http->SetRequestHeader('timestamp',$timestamp);
$http->SetRequestHeader('token',$token);

$http->SessionLogFilename = 'qa_output/payeezy.txt';

$url = 'https://api-cert.payeezy.com/v1/transactions';
// resp is a Chilkat.HttpResponse
$resp = $http->PostJson2($url,'application/json',$json->emit());
if ($http->LastMethodSuccess != 1) {
    print $http->LastErrorText . "\n";
    exit;
}

print 'response status code = ' . $resp->StatusCode . "\n";
$json->Load($resp->BodyStr);
print $json->emit() . "\n";

// Sample JSON response:

// {
//   "correlation_id": "228.4604632998994",
//   "transaction_status": "approved",
//   "validation_status": "success",
//   "transaction_type": "authorize",
//   "transaction_id": "ET175628",
//   "transaction_tag": "2313721985",
//   "method": "credit_card",
//   "amount": "1299",
//   "currency": "USD",
//   "cvv2": "M",
//   "token": {
//     "token_type": "FDToken",
//     "token_data": {
//       "value": "9732261336638291"
//     }
//   },
//   "card": {
//     "type": "visa",
//     "cardholder_name": "John Smith",
//     "card_number": "8291",
//     "exp_date": "1020"
//   },
//   "bank_resp_code": "100",
//   "bank_message": "Approved",
//   "gateway_resp_code": "00",
//   "gateway_message": "Transaction Normal"
// }
// 

print $json->stringOf('correlation_id') . "\n";
print $json->stringOf('transaction_status') . "\n";
print $json->stringOf('validation_status') . "\n";
print $json->stringOf('transaction_type') . "\n";
print $json->stringOf('transaction_id') . "\n";
print $json->stringOf('transaction_tag') . "\n";
print $json->stringOf('method') . "\n";
print $json->stringOf('amount') . "\n";
print $json->stringOf('currency') . "\n";
print $json->stringOf('cvv2') . "\n";
print $json->stringOf('token.token_type') . "\n";
print $json->stringOf('token.token_data.value') . "\n";
print $json->stringOf('card.type') . "\n";
print $json->stringOf('card.cardholder_name') . "\n";
print $json->stringOf('card.card_number') . "\n";
print $json->stringOf('card.exp_date') . "\n";
print $json->stringOf('bank_resp_code') . "\n";
print $json->stringOf('bank_message') . "\n";
print $json->stringOf('gateway_resp_code') . "\n";
print $json->stringOf('gateway_message') . "\n";

?>