The CitrusPay iOS SDK enables collection of payments via various payment methods.
The SDK is designed for CitrusPay partners who are developing their own iOS apps. The SDK provides a native integration to accept payments within these apps that is easy to integration and provides a high performance, functional checkout experience.
##Features CitrusPay iOS SDK broadly offers following features.
- Creating Citrus account for the user
- Prepaid Payments
- Payments via credit/debit card (CC, DC) or netbanking payments (NB)
- Saving Credit/Debit cards into user's account for easier future payments by abiding The Payment Card Industry Data Security Standard (PCI DSS)
- Loading Money into users Citrus prepaid account for Prepaid facility
- Withdraw the money back into User's bank account from the Prepaid account
- On-Demand asset loading (Via CitrusGraphics library)
- One Tap payments for the Saved Cards
- Subscribe to periodic autoload of Citrus Wallet
- Split payments
- Dynamic Pricing, offer coupons, surcharge
- SDK support login screen to simplify Login
- Swift Version 3.1 Support with Xcode 8.3
- A lightweight, pure-Swift library for downloading and caching images from the Citrus cloud
- Swift Version 3.1 Support with Xcode 8.3
- Dynamic Assets available to module for their assets requirements
- SDK have both default & low resolution image for it which will be replaced by high resolution image once asset is downloaded and cached based on device specification
- LazyPay checkout - Buy now, Pay Later!
- Native iOS integration
- Simple lightweight integration
- Enable seamless payments for low value online purchases
- Faster transactions and with higher transaction success rates for merchants
- Native iOS integration
- Simple lightweight integration
- Easy to integrate and use library
- Provides a ready to use, drop in set of User Screens to enable payments with iOS Apps
- Provide an end to end payment experience with all the features offered by the Citrus SDK
- Reduces integration friction as merchants do not have to worry about designing the checkout screen, bank assets, or deal with complexity required to handle different payments methods
- The payment component enables you to accept payments from your users through a wide variety of payment instruments such as Citrus Wallet, Virtual Currency, Cards or Netbanking
- The Wallet/User profile component provides a single user interface to users and enables them to:
- Load Money in user’s Citrus Wallet
- Subscribe to periodic autoload of Citrus Wallet
- Manage saved cards
- Withdraw money from his Citrus Wallet to the bank account
####The full SDK ChangeLog is also available
An example project is available via CocoaPods or manual-inclusion to try out and familiarize yourself with the Citrus Payments SDK. This project comes bundled with the SDK.
via CocoaPods - To run the example project, clone the repo, and run pod install from the Example directory first.
- Xcode 8 or higher.
###Prerequisites to integrating with Citrus PG
- You need to enroll with Citrus as a merchant.
- You need to host Bill generator on your server
- You need to host Return Url Page on your server. (After the transaction is complete, Citrus posts a response to this URL.)
- Make sure that you have obtained following parameters from your Citrus admin panel
- Merchant Secret Key
- Merchant Access Key
- SignIn Key
- SignIn Secret
- SignUp Key
- SignUp Secret
Note: Please ensure all the requirements mentioned above are met before proceeding.
Using CocoaPods (recommended)
CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:
$ gem install cocoapods
To integrate CitrusPay into your Xcode project using CocoaPods, specify it to a target in your Podfile:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target 'MyApp' do
# your other pod
# ...
pod 'CitrusPay', '~> 4.1.5'
end
Then, run the following command:
$ pod install
- Done!
You should open the {Project}.xcworkspace instead of the {Project}.xcodeproj after you installed anything from CocoaPods.
If you do not wish to use CocoaPods then the secondary recommendation is to use a submodule. This allows you to easily track updates using standard Git commands. The first step to installation is to add the submodule to your project:
$ cd /path/to/MyApplication
# If this is a new project, initialize git...
$ git init
$ git submodule add git://github.com/citruspay/citruspay-ios-sdk.git
$ git submodule update --init --recursive
$ open citruspay-ios-sdk
- Navigate to "Framework" folder & drag "core-sdk" folder into your existing Xcode project
- Select the target and Navigate to
Build Phasestab and expand theLink Binary With Librariessection - Click the + and
CitrusPay.frameworkappropriate to your target's platform - Then navigate to
Generaltab and expand theEmbedded Binariessection - Click the + and
CitrusPay.frameworkappropriate to your target's platform
If you’d like to download and maintain the SDK manually, please follow the steps listed below:
- Clone it using following command
$ git clone --recursive https://github.com/citruspay/citruspay-ios-sdk.git
$ open citruspay-ios-sdk
- Navigate to the Citrus "Framework" folder & drag the "core-sdk" folder into your existing Xcode project
- In Xcode, go to your app's target settings. Under the
Build Phasestab, expand theLink Binary With Librariessection. - Include the following framework:
CitrusPay.framework
- In Xcode, go to your app's target settings. Under the
Generaltab, expand theEmbedded Binariessection. - Include the following framework:
CitrusPay.framework
- Navigate to "Dependency" folder & drag the
JSONModel.xcodeprojfrom sub-folder into your Xcode project (i.e using direct project dependency) - Select the target and Navigate to
Build Phasestab and expand theLink Binary With Librariessection - Click the + and
JSONModel.frameworkappropriate to your target's platform - Then navigate to
Generaltab and expand theEmbedded Binariessection - Click the + and
JSONModel.frameworkappropriate to your target's platform
- Navigate to "Framework" folder & drag "graphics-sdk" folder into your existing Xcode project
- Select the target and Navigate to
Build Phasestab and expand theLink Binary With Librariessection - Click the + and
CitrusGraphics.frameworkappropriate to your target's platform - Then navigate to
Generaltab and expand theEmbedded Binariessection - Click the + and
CitrusGraphics.frameworkappropriate to your target's platform
-
Navigate to "Dependency" folder & drag the
Kingfisher.xcodeprojfrom sub-folder into your Xcode project (i.e using direct project dependency) -
Select the target and Navigate to
Build Phasestab and expand theLink Binary With Librariessection -
Click the + and
Kingfisher.frameworkappropriate to your target's platform -
Then navigate to
Generaltab and expand theEmbedded Binariessection -
Click the + and
Kingfisher.frameworkappropriate to your target's platform -
Link your app to SystemConfiguration.framework
-
Done!
After installation, you must import the CitrusPay SDK in your project by adding this:
Swift
import CitrusPay
Objective-C
#import <CitrusPay/CitrusPay.h>
to the files in which you want to use this framework.
Once you prepared, continue to have a look at the Documentation to see how to use CitrusPay.
HTML documentation is hosted on our CitrusPay Developer Guide.
Git Wiki documentation is available on the Git Wiki Documentation.
CitrusPay.h is the starting point for consuming the SDK, and contains the primary class you will interact with.
It exposes all the methods you can call to accept payments via the supported payment methods.
Detailed reference documentation is available on the reference page for the CitrusPay class.
All other classes in the SDK are data models that are used to exchange data between your app and the SDK. Detailed reference documentation is available on the reference page for each class.
Head over to the Git Wiki Documentation to see all the API methods available.
See the the latest releases page
Head over to the Git Wiki Documentation to see all the API methods available. When you are ready, look at the samples below to learn how to interact with the SDK.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent