Developer Zone
These docs are for v3.2.6. Click to read the latest docs for v4.3.0.

Card tokenization

'Card Tokenization' Securely save your customers' credit card information in 2C2P PGW Vault.

👍

Download Server-to-browser sample code

PHP Code

👍

Download Server-to-Server sample code

PHP Code

📘

Environment

Please refer Demo & Live Endpoint.

Set account credentials

<?php 
	//Merchant's account information
	$merchantID = "JT01";		//Get MerchantID when opening account with 2C2P
	$secretKey = "7jYcp4FxFdf0";	//Get SecretKey from 2C2P PGW Dashboard

Set transaction information

//Transaction Information
	$desc = "2 days 1 night hotel room";
	$uniqueTransactionCode = time();
	$currencyCode = "702";
	$amt  = "000000000010";
	$panCountry = "SG";

	//Customer Information
	$cardholderName = "John Doe";

Set encrypted card data

//Encrypted card data
	$encCardData = $_POST['encryptedCardInfo'];

	//Retrieve card information for merchant use if needed
	$maskedCardNo = $_POST['maskedCardInfo'];
	$expMonth = $_POST['expMonthCardInfo'];
	$expYear = $_POST['expYearCardInfo'];

Enable Tokenization

Set payment option

🚧

'storeCard' parameter must be included in hash compute value

//Payment Options
	$storeCard = "Y";		//Enable / Disable Tokenization

Set payment request information

//Request Information 
	$version = "9.9";

Construct payment request message

//Construct payment request message
	$xml = "<PaymentRequest>
		<merchantID>$merchantID</merchantID>
		<uniqueTransactionCode>$uniqueTransactionCode</uniqueTransactionCode>
		<desc>$desc</desc>
		<amt>$amt</amt>
		<currencyCode>$currencyCode</currencyCode>  
		<panCountry>$panCountry</panCountry> 
		<cardholderName>$cardholderName</cardholderName>
    <storeCard>$storeCard</storeCard>
		<encCardData>$encCardData</encCardData>
		</PaymentRequest>"; 
  $paymentPayload = base64_encode($xml); //Convert payload to base64
  $signature = strtoupper(hash_hmac('sha256', $paymentPayload, $secretKey, false));
  $payloadXML = "<PaymentRequest>
           <version>$version</version>
           <payload>$paymentPayload</payload>
           <signature>$signature</signature>
           </PaymentRequest>"; 
  $payload = base64_encode($payloadXML); //encode with base64
?>

Submit payment request form

<form action='https://demo2.2c2p.com/2C2PFrontEnd/SecurePayment/PaymentAuth.aspx' method='POST' name='paymentRequestForm'> 
	Processing payment request, Do not close the browser, press back or refresh the page. 
	<?php echo "<input type='hidden' name='paymentRequest' value='".$payload."'>"; ?>
</form>
<script language="JavaScript">
	document.paymentRequestForm.submit();	//submit form to 2c2p PGW
</script>

Complete Code
Copy & Paste below file code and put this file in your Web Server.

<?php 
	//Merchant's account information
	$merchantID = "JT01";		//Get MerchantID when opening account with 2C2P
	$secretKey = "7jYcp4FxFdf0";	//Get SecretKey from 2C2P PGW Dashboard

	//Transaction Information
	$desc = "2 days 1 night hotel room";
	$uniqueTransactionCode = time();
	$currencyCode = "702";
	$amt  = "000000000010";
	$panCountry = "SG";

	//Customer Information
	$cardholderName = "John Doe";
 
	//Encrypted card data
	$encCardData = $_POST['encryptedCardInfo'];

	//Retrieve card information for merchant use if needed
	$maskedCardNo = $_POST['maskedCardInfo'];
	$expMonth = $_POST['expMonthCardInfo'];
	$expYear = $_POST['expYearCardInfo'];

	//Payment Options
	$storeCard = "Y";		//Enable / Disable Tokenization
 
	//Request Information 
	$version = "9.9";
   
	//Construct payment request message
	$xml = "<PaymentRequest>
		<merchantID>$merchantID</merchantID>
		<uniqueTransactionCode>$uniqueTransactionCode</uniqueTransactionCode>
		<desc>$desc</desc>
		<amt>$amt</amt>
		<currencyCode>$currencyCode</currencyCode>  
		<panCountry>$panCountry</panCountry> 
		<cardholderName>$cardholderName</cardholderName>
    <storeCard>$storeCard</storeCard>
		<encCardData>$encCardData</encCardData>
		</PaymentRequest>"; 
  $paymentPayload = base64_encode($xml); //Convert payload to base64
  $signature = strtoupper(hash_hmac('sha256', $paymentPayload, $secretKey, false));
  $payloadXML = "<PaymentRequest>
           <version>$version</version>
           <payload>$paymentPayload</payload>
           <signature>$signature</signature>
           </PaymentRequest>"; 
  $payload = base64_encode($payloadXML); //encode with base64
?>

<form action='https://demo2.2c2p.com/2C2PFrontEnd/SecurePayment/PaymentAuth.aspx' method='POST' name='paymentRequestForm'> 
	Processing payment request, Do not close the browser, press back or refresh the page. 
	<?php echo "<input type='hidden' name='paymentRequest' value='".$payload."'>"; ?>
</form>
<script language="JavaScript">
	document.paymentRequestForm.submit();	//submit form to 2c2p PGW
</script>

To do so the following fields need to be populated

VariableDescription
storeCardSelection to store cardholder data at 2C2P (Conditional)
If storecard value is ‘Y’, 2C2P will response with unique ID for the card data upon successful authorization. Next payment can be made by sending unique ID instead of full card information.
Note: If storeCardUniqueID is present in the same request, this option will be ignored.

Note: In order for a token to be generated the initial payment request needs to be authorized successfully.

Next: Payment with token

Updated almost 3 years ago