Sample code for 30+ languages & platforms
Dart

Payeezy Place Temp Authorization Hold on Buyer’s Credit Card

See more HTTP Misc Examples

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 Dart Downloads

Dart
import 'package:chilkat/chilkat.dart';

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

  final crypt = CkCrypt2();
  final prng = CkPrng();

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

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

  final dtNow = CkDateTime();
  dtNow.setFromCurrentSystemTime();
  final sbTimestamp = CkStringBuilder();
  // Get the epoch timestamp in seconds
  sbTimestamp.append(dtNow.getAsUnixTimeStr(false));
  // 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).
  final timestamp = sbTimestamp.getAsString();
  print('timestamp = $timestamp');

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

  final json = CkJsonObject();
  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 = false;
  print(json.emit());

  // string hashData = apiKey + nonce + timestamp + token + jsonString;
  final sbHmacData = CkStringBuilder();
  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';
  final hexHash = crypt.macStringENC(sbHmacData.getAsString());
  print('hexHash = $hexHash');

  // Now base64 encode the hex string:
  final sbBase64Hash = CkStringBuilder();
  sbBase64Hash.append(hexHash);
  sbBase64Hash.encode('base64', 'utf-8');

  print('This is the Authorization header to be sent with the payeezy request:');
  print('Authorization: ${sbBase64Hash.getAsString()}');

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

  final http = CkHttp();

  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';

  final url = 'https://api-cert.payeezy.com/v1/transactions';
  final resp = CkHttpResponse();
  try {
    http.httpJson('POST', url, json, 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('response status code = ${resp.statusCode}');
  json.load(resp.bodyStr);
  print(json.emit());

  // 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'));
  print(json.stringOf('transaction_status'));
  print(json.stringOf('validation_status'));
  print(json.stringOf('transaction_type'));
  print(json.stringOf('transaction_id'));
  print(json.stringOf('transaction_tag'));
  print(json.stringOf('method'));
  print(json.stringOf('amount'));
  print(json.stringOf('currency'));
  print(json.stringOf('cvv2'));
  print(json.stringOf('token.token_type'));
  print(json.stringOf('token.token_data.value'));
  print(json.stringOf('card.type'));
  print(json.stringOf('card.cardholder_name'));
  print(json.stringOf('card.card_number'));
  print(json.stringOf('card.exp_date'));
  print(json.stringOf('bank_resp_code'));
  print(json.stringOf('bank_message'));
  print(json.stringOf('gateway_resp_code'));
  print(json.stringOf('gateway_message'));
}