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

RPP (Recurring payment plan)

👍

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 RPP payment option

Set payment option

🚧

All RPP information must be included in hash compute value

//Advance Payment Options
	$recurring = "Y";				//Enable / Disable RPP option
	$invoicePrefix = 'demo'.time();			//RPP transaction invoice prefix
	$recurringAmount = "000000000100";		//Recurring amount
	$allowAccumulate = "N";				//Allow failed authorization to be accumulated
	$maxAccumulateAmt = "";				//Maximum threshold of total accumulated amount
	$recurringInterval = "5";			//Recurring interval by no of days
	$recurringCount = "3";				//Number of Recurring occurance
	$chargeNextDate = (new DateTime('tomorrow'))->format("dmY");	//The first day to start recurring charges. format DDMMYYYY

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>
		<recurring>$recurring</recurring>
		<invoicePrefix>$invoicePrefix</invoicePrefix>
		<recurringAmount>$recurringAmount</recurringAmount>
		<allowAccumulate>$allowAccumulate</allowAccumulate>
		<maxAccumulateAmt>$maxAccumulateAmt</maxAccumulateAmt>
		<recurringInterval>$recurringInterval</recurringInterval>
		<recurringCount>$recurringCount</recurringCount>
		<chargeNextDate>$chargeNextDate</chargeNextDate>
		<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'];

	//Advance Payment Options
	$recurring = "Y";				//Enable / Disable RPP option
	$invoicePrefix = 'demo'.time();			//RPP transaction invoice prefix
	$recurringAmount = "000000000010";		//Recurring amount
	$allowAccumulate = "N";				//Allow failed authorization to be accumulated
	$maxAccumulateAmt = "";				//Maximum threshold of total accumulated amount
	$recurringInterval = "5";			//Recurring interval by no of days
	$recurringCount = "3";				//Number of Recurring occurance
	$chargeNextDate = (new DateTime('tomorrow'))->format("dmY");	//The date the first Recurring transaction should occur. format DDMMYYYY

	//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>
		<recurring>$recurring</recurring>
		<invoicePrefix>$invoicePrefix</invoicePrefix>
		<recurringAmount>$recurringAmount</recurringAmount>
		<allowAccumulate>$allowAccumulate</allowAccumulate>
		<maxAccumulateAmt>$maxAccumulateAmt</maxAccumulateAmt>
		<recurringInterval>$recurringInterval</recurringInterval>
		<recurringCount>$recurringCount</recurringCount>
		<chargeNextDate>$chargeNextDate</chargeNextDate>
		<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
?>  

<!--Construct form to submit authorization request to 2c2p PGW-->
<!--Payment request data should be sent to 2c2p PGW with POST method inside parameter named 'paymentRequest'-->
<form action='https://demo2.2c2p.com/2C2PFrontEnd/SecurePayment/PaymentAuth.aspx' method='POST' name='paymentRequestForm'> 
	<!--display wait message to user when page is loading-->
	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>

Next: API parameters