(Lianja) 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 Lianja Extension Download Chilkat Lianja Extension

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

loCrypt = createobject("CkCrypt2")
loPrng = createobject("CkPrng")

// An API key such as y6pWAJNyJyjGv66IsVuWnklkKUPFbb0a
lcApiKey = "my_api_key"
// An API secret such as 86fbae7030253af3cd15faef2a1f4b67353e41fb6799f576b5093ae52901e6f7
lcApiSecret = "my_api_secret"
// A token such as fdoa-a480ce8951daa73262734cf102641994c1e55e7cdf4c02b6
lcToken = "my_merchant_token"

// The nonce is a random number (bytes), something like "6057786719490086000"
lcNonce = loPrng.GenRandom(8,"decimal")
? "nonce = " + lcNonce

loDtNow = createobject("CkDateTime")
loDtNow.SetFromCurrentSystemTime()
loSbTimestamp = createobject("CkStringBuilder")
// Get the epoch timestamp in seconds
loSbTimestamp.Append(loDtNow.GetAsUnixTimeStr(.F.))
// Change it to milliseconds
loSbTimestamp.Append("000")
// The timestamp is a number similar to this: 1546011905000 (which is a timestamp taken on 28-Dec-2018).
lcTimestamp = loSbTimestamp.GetAsString()
? "timestamp = " + lcTimestamp

// 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"
//   }
// }

loJson = createobject("CkJsonObject")
loJson.UpdateString("merchant_ref","Astonishing-Sale")
loJson.UpdateString("transaction_type","authorize")
loJson.UpdateString("method","credit_card")
loJson.UpdateString("amount","1299")
loJson.UpdateString("currency_code","USD")
loJson.UpdateString("credit_card.type","visa")
loJson.UpdateString("credit_card.cardholder_name","John Smith")
loJson.UpdateString("credit_card.card_number","4788250000028291")
loJson.UpdateString("credit_card.exp_date","1020")
loJson.UpdateString("credit_card.cvv","123")
loJson.EmitCompact = .F.
? loJson.Emit()

// string hashData = apiKey + nonce + timestamp + token + jsonString;
loSbHmacData = createobject("CkStringBuilder")
loSbHmacData.Append(lcApiKey)
loSbHmacData.Append(lcNonce)
loSbHmacData.Append(lcTimestamp)
loSbHmacData.Append(lcToken)
loSbHmacData.Append(loJson.Emit())

// HMAC the data to produce a hex string.
loCrypt.EncodingMode = "hexlower"
loCrypt.MacAlgorithm = "hmac"
loCrypt.SetMacKeyString(lcApiSecret)
loCrypt.HashAlgorithm = "sha256"
loCrypt.Charset = "utf-8"
lcHexHash = loCrypt.MacStringENC(loSbHmacData.GetAsString())
? "hexHash = " + lcHexHash

// Now base64 encode the hex string:
loSbBase64Hash = createobject("CkStringBuilder")
loSbBase64Hash.Append(lcHexHash)
loSbBase64Hash.Encode("base64","utf-8")

? "This is the Authorization header to be sent with the payeezy request:"
? "Authorization: " + loSbBase64Hash.GetAsString()

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

loHttp = createobject("CkHttp")

loHttp.Accept = "*/*"
loHttp.UserAgent = ""
loHttp.SetRequestHeader("Authorization",loSbBase64Hash.GetAsString())
loHttp.SetRequestHeader("apikey",lcApiKey)
loHttp.SetRequestHeader("nonce",lcNonce)
loHttp.SetRequestHeader("timestamp",lcTimestamp)
loHttp.SetRequestHeader("token",lcToken)

loHttp.SessionLogFilename = "qa_output/payeezy.txt"

lcUrl = "https://api-cert.payeezy.com/v1/transactions"
loResp = loHttp.PostJson2(lcUrl,"application/json",loJson.Emit())
if (loHttp.LastMethodSuccess <> .T.) then
    ? loHttp.LastErrorText
    release loCrypt
    release loPrng
    release loDtNow
    release loSbTimestamp
    release loJson
    release loSbHmacData
    release loSbBase64Hash
    release loHttp
    return
endif

? "response status code = " + str(loResp.StatusCode)
loJson.Load(loResp.BodyStr)
? loJson.Emit()
release loResp

// 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"
// }
// 

? loJson.StringOf("correlation_id")
? loJson.StringOf("transaction_status")
? loJson.StringOf("validation_status")
? loJson.StringOf("transaction_type")
? loJson.StringOf("transaction_id")
? loJson.StringOf("transaction_tag")
? loJson.StringOf("method")
? loJson.StringOf("amount")
? loJson.StringOf("currency")
? loJson.StringOf("cvv2")
? loJson.StringOf("token.token_type")
? loJson.StringOf("token.token_data.value")
? loJson.StringOf("card.type")
? loJson.StringOf("card.cardholder_name")
? loJson.StringOf("card.card_number")
? loJson.StringOf("card.exp_date")
? loJson.StringOf("bank_resp_code")
? loJson.StringOf("bank_message")
? loJson.StringOf("gateway_resp_code")
? loJson.StringOf("gateway_message")


release loCrypt
release loPrng
release loDtNow
release loSbTimestamp
release loJson
release loSbHmacData
release loSbBase64Hash
release loHttp