iOS Checkout Integration

This is a new integration supported by Cashfree Payments. If you are integrating with our Payment Gateway for the first time, we recommend you use this integration.

We have revamped our iOS SDK to make it easy for our merchants to integrate and customize their payment flows. Our iOS SDK supports iOS 11 and above and offers

Web Checkout - Web checkout flow is the standard payment flow for collecting payments using the Cashfree payment gateway's iOS SDK. In this flow, SDK provides a webview based checkout implementation to facilitate a quick integration with our payment gateway. Your customers can fill in the necessary details in the web page and complete the payment.



We hope you have already created an account with Cashfree Payments and have the API keys ready to start the integration. If not, click here to know how to create an account.

The integration can be completed in a few steps and should not take more than 30 minutes.

  1. Getting the SDK
  2. Create an order with Cashfree from backend (Step 2 in the image below)
  3. Initiate payment(Step 3 in the image below)
  4. Verify payment (Steps 4 & 5 in the image below) - This is a mandatory step so please don't skip this

Simplified payment flow

When a customer places an order on merchant app, merchant needs to create order in Cashfree's system. In response of that request Cashfree will return payment_session_id to you. It contains all the order details and has to be sent to the SDK while initiating the payment. Then checkout page is loaded and customer chooses the payment method he wants to pay by and enters his details (like UPI ID/card number etc). Cashfree uses these details to process the payment and notifies the mobile SDK that payment has ended. Merchant verifies the payment and order status from Cashfree's backend and the same is shown to the customer on his app.


Checkout flow


You can use our sample iOS app project in this Github link as a reference for this SDK integration.

Access on sandbox is provided for everyone and you can use the following endpoint -


You can try out the APIs for Steps 3 and 4 by using any of the following methods

  1. From our postman collection
  2. You can use the following sample php project as reference for the backend APIs.

What’s Next