Overview

The eSewa Mobile SDK enables native iOS (Swift) to easily accept eSewa payments. The SDK supports only one use case for making payment – Single Payment (i.e., one payment per one user login).

client_id and client_secret values are provided by eSewa to its merchant/client and is unique for each. For development phase, you can use the following credentials: client_id: JB0BBQ4aD0UqIThFJwAKBgAXEUkEGQUBBAwdOgABHD4DChwUAB0R client_secret: BhwIWQQADhIYSxILExMcAgFXFhcOBwAKBgAXEQ==

Note : After login, if the device stays ideal for more than 5 minutes before confirming the payment, the particular session will be time out and customer have to re-initiate the payment process.

// In appdelegate 
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
   // registering fonts
    UIFont.loadFonts() 
  }
 

1. SDK for Simulator/Testing purpose can only be used while selecting the build device as Simulator.2. SDK for Appstore/Release can only be used while selecting the actual build device or while creating the archive for release purpose.

After that,the following code should added:For Swift Version 3.0 & aboveStep 1:Initialize eSewa SDK.Make Sure sdk is an Instance Variable.

import EsewaSDK
class TestViewController: UIViewController {

    // Keep it in class instance
    var sdk: EsewaSDK?

    override func viewDidLoad() {
        super.viewDidLoad()
    }

    func testSdkButtonTap() {
        //Start payment process
        sdk = EsewaSDK(inViewController: self, environment: .development, delegate: self)
        sdk?.initiatePayment(merchantId: “”, merchantSecret: “”, productName: "", productAmount: "", productId: "", callbackUrl: "")
    }

} 

Lastly, add two EsewaSDKPaymentDelegate methods to observe the success or failure of transaction from the sdk.

func onEsewaSDKPaymentSuccess(info:[String:Any]) {
    // Called when the payment is success. Info contains the detail of transaction.
}

func onEsewaSDKPaymentError(errorDescription: String) {
    // Called when there is error with the description of the error.
} 

Every step is same as before except change in the syntax as follows:

let s = UIStoryboard(name: "esewa", bundle: NSBundle(forClass: RequestViewController.self))
let vc = s.instantiateViewControllerWithIdentifier("NetworkSearch") as! RequestViewController
vc.sendForAuthentication("", "", "{environment}", "", "", "","")presentViewController(vc, animated: true, completion: nil)

NSNotificationCenter.defaultCenter().addObserver(self, selector: #selector(ViewController.getTransactionDetails(_:)), name: "NotificationIdentifier", object: nil)}

//Observe the notification as shown below
func getTransactionDetails(notification: NSNotification) {
      let detailsValue = notification.object as! [String: AnyObject] 
      print("details Value of transaction Details : \(detailsValue)")
    } 

Where,

Call Back Url

Callback-url is an API exposed at merchant/client's server at which eSewa sends a copy of proof of payment after successful payment; the client/merchant must send a callback-url while initiating the payment through SDK. The sent callback-url is later used by eSewa server to send a copy of proof of payment after a payment is received. The callback-url is a POST method API and should be in this format

• 1. Invalid Merchant Id or Secret Key SDK handles all of the errors and displays appropriate alert to end user. Here are the error cases that can occur in each of the step during implementation of eSewa SDK implementation.

• 2. No Internet Connection. SDK shows dialog box with message "Internet not available" to end user.

• 3. Invalid Test Environment If environment of sdk is set to .development in production mode or vice versa, SDK shows message "Sorry your request failed. Contact your service provider." to end user.

• 1. No Internet Connection SDK shows dialog box with message "Internet not available" to end user.

• 2. Invalid user name or password SDK shows message Invalid username or password to customer and clears password field.

• 3. Canceled by customer If end user presses Back Button or Cancel button then user is returned to the screen the sdk is initiated from.

• 1. No Internet Connection SDK shows dialog box with message "Internet not available" to customer. He can turn on Internet and proceed to confirming their payment.

• 2. Insufficient Balance SDK compares the customer's current balance with the total payment amount of the product or service. Payment request is sent if and only if the customer has sufficient balance else the following message will be shown “Your balance is less than required total amount” and will be bound to cancel the payment.

• 3. Canceled by user If end user presses Back Button or Cancel button then user is returned to the screen the sdk is initiated from.

• 4. Session Timeout If the device is kept ideal for 2 minutes then the particular session for payment expires and user has to re-process the payment again.

In case of mobile devices, We suggest to use the TXN verification API with txnRefId to verify ur transaction status and check for “status” key in “transactionDetails” object from the response body. “status” => “COMPLETE” means the transaction verification is successful. For live enviromment, please remove 'rc' from url

https://rc.esewa.com.np/mobile/transaction?txnRefId={refId}

REQUEST TYPE : GET merchantId : *********************************************** merchantSecret : *********************************************** Content-Type : application/json

[
    {
        "productId": "1999",
        "productName": "Android SDK Payment",
        "totalAmount": "25.0",
        "code": "00",
        "message": {
            "technicalSuccessMessage": "Your transaction has been completed.",
            "successMessage": "Your transaction has been completed."
        },
        "transactionDetails": {
            "date": "Mon Dec 26 12:58:14 NPT 2022",
            "referenceId": "0004VZR",
            "status": "COMPLETE"
        },
        "merchantName": "Android SDK Payment"
    }
]