cashfree_pg 0.0.2+2

A Flutter plugin for Cashfree PG integration. It opens the payment page in a flutter_webview.

Cashfree PG Flutter SDK

Integration Steps

Step 1: Add Dependency

  cashfree_pg: 0.0.2

Step 3: Add permissions (Android)

The Cashfree PG SDK requires that you add the INTERNET permission in your Android Manifest file.

<manifest ...>
    <uses-permission android:name="android.permission.INTERNET" />
<application ...>

Step 4: Add plist value (iOS)

Opt-in to the embedded views preview by adding a boolean property to the app's Info.plist file with the key io.flutter.embedded_views_preview and the value YES. This is required by the flutter_webview plugin.

    <key>io.flutter.embedded_views_preview</key>
    <true/>

Step 4: Generate Token (From Backend)

You will need to generate a token from your backend and pass it to app while initiating payments. For generating token you need to use our token generation API. Please take care that this API is called only from your as it uses secretKey. Thus this API should never be called from App.

Request Description

You need to send orderId, orderCurrency and orderAmount as a JSON object to the API endpoint and in response a token will received. Please see the description of request below.

curl -XPOST -H 'Content-Type: application/json' 
-H 'x-client-id: <YOUR_APP_ID>' 
-H 'x-client-secret: <YOUR_SECRET_KEY>' 
-d '{
  "orderId": "<ORDER_ID>",
  "orderAmount":<ORDER_AMOUNT>,
  "orderCurrency": "INR"
}' 'https://test.cashfree.com/api/v2/cftoken/order'

Request Example

Replace YOUR_APP_ID and YOUR_SECRET_KEY with actual values.

curl -XPOST -H 'Content-Type: application/json' -H 'x-client-id: YOUR_APP_ID' -H 'x-client-secret: YOUR_SECRET_KEY' -d '{
  "orderId": "Order0001",
  "orderAmount":1,
  "orderCurrency":"INR"
}' 'https://test.cashfree.com/api/v2/cftoken/order'

Response Example

{
"status": "OK",
"message": "Token generated",
"cftoken": "v79JCN4MzUIJiOicGbhJCLiQ1VKJiOiAXe0Jye.s79BTM0AjNwUDN1EjOiAHelJCLiIlTJJiOik3YuVmcyV3QyVGZy9mIsEjOiQnb19WbBJXZkJ3biwiIxADMwIXZkJ3TiojIklkclRmcvJye.K3NKICVS5DcEzXm2VQUO_ZagtWMIKKXzYOqPZ4x0r2P_N3-PRu2mowm-8UXoyqAgsG"
}

The "cftoken" is the token that is used authenticate your payment request that will be covered in the next step.

Step 5: Initiate Payment

• App passes the order info and the token to the SDK
• Customer is shown the payment screen where he completes the payment
• Once the payment is complete SDK verifies the payment
• App receives the response from SDK and handles it appropriately

NOTE

• The order details passed during the token generation and the payment initiation should match. Otherwise you'll get a"invalid order details" error.
• Wrong appId and token will result in "Unable to authenticate merchant" error. The token generated for payment is valid for 5 mins within which the payment has to be initiated. Otherwise you'll get a "Invalid token" error.

Payment modes

Web Checkout Integration

How to integrate

For both the modes (normal and seamless) you need to invoke the doPayment() method. However, there are a few extra parameters you need to pass incase of seamless mode.

doPayment

Future<dynamic> doPayment(BuildContext context, Map<String, String> inputs, String mode)

Initiates the payment in a webview. The customer will be taken to the payment page on cashfree server where they will have the option of paying through any payment option that is activated on their account. Once the payment is done the webview will close and the response will be delivered in the callback.

Parameters:

• context: BuildContext object of the widget.

• params: A map of all the relevant parameters described in the Request Params section below.

• token: The token generated from Step 4.

• stage: Value should be either "TEST" or "PROD" for testing server or production server respectively.

doPayment - with Custom AppBar Theme

Future<dynamic> doPaymentWithTheme(BuildContext context, Map<String, String> inputs, Color color1, Color color2, String mode)

Initiate the payment in a webview. The customer will be taken to the payment page on cashfree server where they will have the option of paying through any payment option that is activated on their account. Once the payment is done the webview will close and the response will be delivered in the callback.

Parameters:

• context: BuildContext object of the widget.

• params: A map of all the relevant parameters described in the Request Params section below.

• token: The token generated from Step 4.

• stage: Value should be either "TEST" or "PROD" for testing server or production server respectively.

• color1: Toolbar background color

• color2: Toolbar text and back arrow color

Sample Code

CashfreePGSDK().doPayment(context, inputs, "TEST").then((val){
        print("SDK Result : ${(val)}");
        // DO something with the result
}


CashfreePGSDK().doPaymentWithTheme(context, inputs, Colors.white, Colors.black,  "TEST").then((val){
        print("SDK Result : ${(val)}");
        // DO something with the result
}

Request Parameters

Parameter	Required	Description
appId	Yes	Your app id
orderId	Yes	Order/Invoice Id
orderAmount	Yes	Bill amount of the order
orderNote	No	A help text to make customers know more about the order
orderCurrency	Yes	Currency code of the order. Default is INR.
customerName	No	Name of the customer
customerPhone	Yes	Phone number of customer
customerEmail	Yes	Email id of the customer
notifyUrl	No	Notification URL for server-server communication. Useful when user’s connection drops after completing payment.
paymentModes	No	Allowed payment modes for this order. Available values: cc, dc, nb, paypal, upi, wallet. Leave it blank if you want to display all modes

Response parameters

These parameters are sent as extras to the onActivityResult(). They contain the details of the transaction.

Parameter	Description
orderId	Order id for which transaction has been processed. Ex: GZ-212
orderAmount	Amount of the order. Ex: 256.00
paymentMode	Payment mode of the transaction.
referenceId	Cashfree generated unique transaction Id. Ex: 140388038803
txStatus	Payment status for that order. Values can be : SUCCESS, FLAGGED, PENDING, FAILED, CANCELLED.
paymentMode	Payment mode used by customer to make the payment. Ex: DEBIT_CARD, MobiKwik, etc
txMsg	Message related to the transaction. Will have the reason, if payment failed
txTime	Time of the transaction
type	Fixed value : CashFreeResponse. To identify the response is from cashfree SDK.
signature	Response signature, more here.

NOTE

There can be scenarios where the SDK is not able to verify the payment within a short period of time. The status of such orders will be PENDING.