Get User Instruments

Get User Instruments options from SDK

Copied !

Initialise the PhonePeUserAccount

let phonePeUserAccount = PhonePeUserAccount(
                     appSchema: "YOUR_APP_SCHEMA",
                     delegate: self)

Interface looks like below

public protocol PhonePeUserAccountProvider: AnyObject {
    func onInstrumentsReady(instruments: [PhonePePayment.Instrument]?, failure: PhonePePayment.SavedInstrumentFailure?)
    func showLinkButton()
    func hideLinkButton(_ state: PhonePePayment.OptionState)
    func onConsentGiven()
    func onConsentNotGiven()
}

Example and callback details

You need to conforms to this protocol in your class and define all the methods for callbacks.

func showLinkButton() : You get this callback when phonepe doesn’t have user consent to share phonepe options. Once you get this callback, show your UI with which user can interact with to trigger the consent (preferably a button which says link phonepe).

extension SavedInstrumentViewModel: PhonePeUserAccountProvider {
    func showLinkButton() {
	  consoleLog(“Show Link Button”)        
    }
}

func hideLinkButton(): When you get this callback, you can hide your UI for linking phonepe account. You additionaly get the reason in the param failure. You can optionally log it on your side for any issue debugging.

func hideLinkButton(_ failure:
 PhonePePayment.OptionState) {
         consoleLog(failure)
    }

func onConsentGiven(): You can optionally override this. This callback is given when user accepts the consent.

func onConsentGiven() {
     consoleLog("Consent Given", type: .success)
    }

func onConsentNotGiven(): This callback is given when user rejects the consent.

func onConsentNotGiven() {
        consoleLog("Consent Not Given", type: .error)
    }

Call getUserInstruments(token: String) method of PhonePeUserAccount instance.

phonePeUserAccount.getUserInstruments(token: "YOUR_TOKEN")

For linking the PhonePe app for payment options, Call the link method of the PhonePeUserAccount

phonePeUserAccount.link()

After getting the consent, We will call the Instrument api and get the options to you.

func onInstrumentsReady(instruments:[PhonePePayment.Instrument]?, failure:PhonePePayment.SavedInstrumentFailure?) {
	 consoleLog(instruments)        
	 consoleLog(failure)
    }

Merchants should render the received saved Instruments on the checkout page. Once user selects one of the instrument then move to the Initiate Payment step.

public struct Instrument: Codable {
  public let type: String?
  public let title: String?
  public let subTitle: String?
  public let logoUrl: String?
  public let id: String?
  public let priority: Int?
  public let available: Bool?
  public let subType: String?
  public let bankCode: String?
  public let networkLogoUrl: String?
  public let metaInfo: [[String: AnyValue]]?
}