Download the php folder from the above repository.You can refer here to download a single folder from the repository.
1)Apache web server
2)Ruby on Rails
Below we describe the Ruby integration for Cashfree PG. You'll need Cashfree credentials for this setup to work. You can access the credentials from the merchant dashboard (API access > credentials) here.
Step 1
-Open the project(pgsim) in terminal and type the below commands
```
rails server
```
-
Open the file request.php, and update the value of the variable $mode to "TEST"(for testing) or "PROD"(for production) depending on your environment.
-
Update the variable $secretKey with the correct value for the mode you have selected in request.php and response.php files.
Step 2
-
Visit localhost/php/start.php in the browser, fill in the details as required, set the returnUrl as localhost/php/response.php and click Submit.
-
Once the payment page loads, enter the following card details for testing purpose.
Card Number : 4111 1111 1111 1111
CVV : 123
You can enter any name, month and year for card expiration. For more details around test cards, see Test Data.
Step 3
- Once you've entered the details you will be redirected to the Cashfree PG Simulator page. Here you can simulate either a failed or a successful transaction. You will then be redirected to the returnUrl(given in step 2) with the transaction details.
NOTE :
- In the file request.php, please make sure that you are using the correct integration mode.
- Give a valid returnUrl, since all the transaction details will be sent to it.
- It is imperative that you process the response correctly to prevent any fraud on your website.
To start integrating in production you just need to change the $mode in request.php to "PROD" and get the production credentials from (API access > credentials) here. Also update the variable $secretkey in request.php and response.php files.
Start.php
This file collects the required details for processing a payment request. You can easily modify and integrate it in your website. Note that the form action should be as "request.php".
<form id="redirectForm" method="post" action="request.php">Request.php
This file receives the request from start.php and generates the correct PG details to send over to Cashfree. This includes a signature variable which is used to authenticate each request. The following code is used to generate the signature from the provided details.
$secretKey = "<YOUR_SECRET_KEY_HERE>";
$postData = array(
"appId" => $appId,
"orderId" => $orderId,
"orderAmount" => $orderAmount,
"orderCurrency" => $orderCurrency,
"orderNote" => $orderNote,
"customerName" => $customerName,
"customerPhone" => $customerPhone,
"customerEmail" => $customerEmail,
"returnUrl" => $returnUrl,
"notifyUrl" => $notifyUrl,
);
ksort($postData);
$signatureData = "";
foreach ($postData as $key => $value){
$signatureData .= $key.$value;
}
$signature = hash_hmac('sha256', $signatureData, $secretKey,true);
$signature = base64_encode($signature);If the signature matches with signature generated by us you will be allowed to proceed to the gateway. We will send the transaction response to the returnUrl provided by you in the request.
Response.php
Here we collect the transaction details, verify that they are valid and have been received from Cashfree. See below code to understand how this verification is done.
$secretkey = "<YOUR_SECRET_KEY_HERE>";
$orderId = $_POST["orderId"];
$orderAmount = $_POST["orderAmount"];
$referenceId = $_POST["referenceId"];
$txStatus = $_POST["txStatus"];
$paymentMode = $_POST["paymentMode"];
$txMsg = $_POST["txMsg"];
$txTime = $_POST["txTime"];
$signature = $_POST["signature"];
$data = $orderId.$orderAmount.$referenceId.$txStatus.$paymentMode.$txMsg.$txTime;
$hash_hmac = hash_hmac('sha256', $data, $secretkey, true) ;
$computedSignature = base64_encode($hash_hmac);Once the verification succeeds we display the transaction details.
For further queries reach us at techsupport@gocashfree.com.