Cashfree.IOS.Payment.SDK 1.0.0

Xamarin IOS SDK

The Cashfree Xamarin IOS SDK allows you to integrate Cashfree Payment Gateway into your application and start collecting payments from your customers.

The Cashfree SDK has been designed to minimise the complexity of handling and integrating payments in your application. The Cashfree Xamarin IOS SDK is available at the Nuget Gallery as a Nuget package.

Integration Steps

To integrate Cashfree Xamarin IOS SDK with your IOS application,

1. Create an account with Cashfree and get the API keys.
2. Integrate the Cashfree SDK into your application.
3. Generate Token (From Backend)4. Initiate payment - Invoke a payment API from the Cashfree SDK with the token generated when the customer initiates payment for an order from your application. Cashfree SDK displays appropriate screens to the customer for the payment.
4. Receive and handle response - Cashfree SDK returns the payment result for the order which should be handled in your application.
5. Verify response - We recommend you to verify the payment response using webhooks and by checking the signature value returned in the payment response.

Initiate Payment

After generating the order token, the payment gets initiated when CFPaymentService().DoWebCheckoutPaymentWithParams() is invoked.

For payment, your application passes the order info and the cftoken to the SDK. The relevant payment screen is displayed to the customer where they enter the required information and make the payment. After the payment is complete the customers are redirected to the IOS application and response is received on ResultDelegate.OnPaymentCompletionWithMsg()

NOTE: The order details passed during the token generation and the payment initiation should match. Else, you will get an 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 minutes within which the payment has to be initiated. Else, you will get an Invalid token error.

Receive and Handle Response

After the payment is complete you will receive the response on the ResultDelegate.OnPaymentCompletionWithMsg() function of the invoking class.

public override void OnPaymentCompletionWithMsg(string msg)
{
	//call your function here.
	func.Invoke(msg);
}

Web Checkout

Web Checkout is the standard flow for Cashfree IOS SDK. In this flow, the SDK loads a webview which will render the payment page. The customer can fill the required payment details here and complete the payment. The Web Checkout can be used in two ways:-

1. Web Checkout with Cashfree UI: Customer selects the payment mode and enters the payment details within the Cashfree's web payment page to complete the payment
2. Seamless Web Checkout: Customer selects the payment mode and enters payment details in your application. These details are then passed on to the Cashfree SDK. Webview is launched only for scenarios like the two-factor authentication.

NOTE: Web checkout supports payment through Google pay, Amazon pay, PhonePe and UPI payment modes.

Web Checkout Using Cashfree UI

Web checkout uses webview to process payment hence the name. For both Web Checkout and Seamless Web Checkout you need to call CFPaymentService().DoWebCheckoutPaymentWithParams(). However, there are a few extra parameters you need to pass for seamless integration method.

DoPayment: Add this package in your class. using Com.Cashfree.PG;

DoWebCheckoutPaymentWithParams (NSDictionary<NSString, NSObject> Params, string Environment, ResultDelegate Callback);

Starts the web checkout. The customer will be taken to the payment page on the Cashfree server where they have the option to pay 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 ResultDelegate.OnPaymentCompletionWithMsg().

Parameters:

1. Params: A map of all the relevant parameters described here
2. Environment: Value should be either "TEST" for testing server, or "PROD" for production server respectively.
3. Callback: ResultDelegate implementation for handling the sdk response.

Example:

new CFPaymentService().DoWebCheckoutPaymentWithParams(Params, Environment, Callback);

Seamless Integration

When you have a requirement for a customised payment flow, you can use the seamless integration. You can implement the payment page as per your requirement and then use our SDK to authorise the payment. Once the payment details are collected the OTP or the two-factor authentication page will open in a webview. After the payment is confirmed the webview closes and you will receive a response. Click here for more info.

Request and Response Parameters

Click here for request and response parameters.