PAYWARE MOBILE API – APP TO APP INTEGRATION

2

PAY WA R E M O B I L E A P I O V E R V I E W

VeriFone’s PAYware Mobile API provides iPhone developers the ability to easily and securely integrate payments into their custom application by using the PA DSS validated payment application, PAYware Mobile. – Developers can create a seamless iPhone App with payment acceptance

while still having the familiar user interface of PAYware Mobile when needed– Added security of VeriShield Protect’s encryption when using the PAYware

Mobile card encryption– Secure data transmission to PAYware Mobile when performing manual

transactions

3

A P P T O A P P I N T E G R AT I O N M A R K E T S

Example Use ScenariosSimple Mobile POS applications for day to day business– Mobile App communicates to the inventory system hosted at company

headquarters. Customer make a purchase and the Merchant can fulfill the order and process payment immediately.

– Data is transmitted to the HQ hosted ERP or inventory management system while tying payment information for easier accounting and payment reconciliation

Charitable Organizations– Payments made at charitable functions can automatically be processed

through the donation App interface while updating the donor database hosted at the charity’s headquarters

– Eases payment collection while keeping data secure

Direct Sales Organizations– A Common order entry Mobile App for large organizations which will keep

track products sold while capturing customer information for future sales.– Payment is taken at the time of order which means the customer can walk out

with their products.

4

T R A N S A C T I O N F L O W

Initial ConfigurationThe Merchant’s iPhone will have both the Merchant’s own iPhone App and the PAYware Mobile App installed and configured on the device. The PAYware Mobile App will be preconfigured and registered with the PAYware Connect Gateway and enabled to be integrated by the Merchant’s iPhone App.

The Merchant is Responsible for loading and configuring the Merchants iPhone App.

The Merchant is responsible for loading and configuring the PAYware Mobile App from the App Store and PAYware Connect Gateway.

Merchant’s iPhone App1. Merchant’s App collects all required elements

prior to performing Payment Transaction.2. Merchant’s App then calls PAYware Mobile App

passing Non-Sensitive Information

PAYware Mobile App3. PAYware Mobile App listens Non-Sensitive Data from Merchant’s App. Once Received PWM will attempt to process payment transaction and collect any other required sensitive information (Credit Card PAN, Expiration Date, Track Data, CVV)

5

T R A N S A C T I O N F L O W

Merchants iPhone APP1. Merchant’s APP collects all required elements

prior to performing Payment Transaction.2. Merchant’s APP then calls PAYware Mobile App

passing Non-Sensitive Information

PAYware Mobile APP3. PAYware Mobile App listens Non-Sensitive Data from Merchant’s App. Once Received PWM will attempt to process payment transaction and collect any other required sensitive information (Credit Card PAN, Expiration Date, Track Data, CVV)

Non-Sensitive Data passed from Merchant’s App to PAYware Mobile

App

1. Transaction Amount2. Tip Amount or Percentage3. Tax Amount or Percentage4. Transaction Type: (Sale, Return,

Pre-Auth, etc..)5. Customer’s First and Last Name6. Customer’s Email Address for

Receipt7. Merchant’s Invoice Number8. Merchant’s Server/Clerk ID9. Up to 5 Additional Custom Fields10. Indicator to Hide or Suppress

PAYware Mobile Transaction log and allow Signature Capture at end of Transaction or return response to Merchant,s iPhone App

6

I N T E G R AT I O N S T E P S

1. Import PAYware.framework into Merchants iPhone App project frameworks

2. Declare import in Merchants iPhone App

7

I N T E G R AT I O N S T E P S C O N T I N U E D

Specify URL types/URL Schemes and /URL Identifier in Merchants iPhone APP Properly List

8

I N T E G R AT I O N S T E P S C O N T I N U E D

Define a VFILink instance and send the VFIRequestData to the sendToPAYware method. If PAYware Mobile is on the device, PAYware Mobile will launch and process the data, otherwise, the method will return false.

9

I N T E G R AT I O N S T E P S C O N T I N U E D

Populate a VFIRequestData object with the data you would like to transfer to PAYware Mobile. The return URL must be the item you defined as Item 0 in the Property List URL Schemes. The identifier can be any value and is used to sync the info with the return data from PAYware Mobile. Examine the VFILink.h file in the PAYware.framework to see the full structure of VFIRequestData. PINCode may be supplied to bypass the PIN request screen of PAYware mobile on launch.

10

I N T E G R AT I O N S T E P S C O N T I N U E D

In the main AppDelegate, define the handleOpenURL method to intercept the URL passed by PAYware Mobile on the return of data. Define an instance of VFILink and pass the URL to receiveFromPAYware. This framework method will return a VFIResponseData object. If hasData is true, then this structure is valid and has data from PAYware Mobile. If hasData is false, then the URL did not come from PAYware Mobile.

11

PAY WA R E M O B I L E A P I I N T E G R AT I O N S U P P O R T

A dedicated PAYware Integration Support team is available to PAYware Mobile integratorsStaffed by developers and support technicians knowledgeable in all aspects of VeriFone software and hardware solutionsA project manager and integration support engineer will be assignedIntegration Support e-mail and telephone support is availableExtensive code samples, documentation and testing accounts minimize development time and support requirements for integratorPAYware end-user (merchant) support is also available 7 days a week

QUESTIONS