Introduction

The PayPal Here SDK enables Android apps to process in-person credit card transactions using an assortment of card readers that are capable of accepting contactless, EMV, and swipe payment methods.

Developers should use the PayPal Here SDK to get world-class payment processing with one simple integration. Some of the main benefits include

• Low, transparent pricing: US Merchants pay just 2.7% per transaction (or 3.5% + $0.15 for keyed in transactions), including cards like American Express, with no additional hidden/monthly costs.
• Safety & Security: PayPal's solution uses encrypted swipers, such that card data is never made available to merchants or anyone else.
• Live customer support: Whenever you need support, we’re available to help with our customer support team. Visit our website for more information about PayPal Here.
• Partner program: Please contact us for any partnership program questions or opportunities.

Note: From 1 July 2021 AEST, PayPal Here services (including both the credit card reader devices and the PayPal Here App) will no longer be available in Australia. This means you will not be able to accept payments through PayPal Here with the credit card reader device or via the PayPal Here App from that date. We have also ceased the sale of new PayPal Here credit card reader devices. If you are looking for a card payment solution, please see here. If you are an existing PayPal Here customer and have any questions, please click here.

Supporting Materials

• PPH SDK integration documentation can be found here.
• PPH SDK class reference can be found here.
• Sample App: Please see and modify the sample app thats available in this repo to experiment and learn more about the SDK and it's capabilities.

Installation

Our recommended installation method is to reference from Maven:

dependencies {
    repositories {
        mavenCentral()
    }

    // api('com.paypal.retail:here-sdk-release:2.0.0.201801@aar'){transitive=true}
    api('com.paypal.retail:here-sdk-debug:2.0.0.201801@aar'){transitive=true}
}

There's both a Debug and Release build available to be referenced. Please make sure that you switch to the Release build prior to pushing your app to the Play Store otherwise your submission will likely be rejected.

Also, if you see a runtime exception java.lang.IllegalStateException: J2V8 native library not loaded, please add the following code. More info on this could be found here paypal-here-sdk-android-distribution/issues/118.

android {
    ....
    defaultConfig {
        ....
        ndk {
            abiFilters "armeabi", "armeabi-v7a", "x86", "mips"
        }
    }
}

Housekeeping Items

There are a few noteworthy items that should be called out. These include:

• Auth/Capture: Please note that auth/capture processing is currently only available for the US and UK.
• Key-in: Even though there's not an example in the sample app, please know that the SDK will support this payment method should you need to implement it.
• Server: There will be some server-side work that needs to be done to handle the token management part of the integration. Standard Oauth2 is used for Merchant Onboarding and more information on this piece can be found here
• Marketing Toolkit: Within this repo, you'll find downloadable marketing assets – from emails to banner ads – to help you quickly, and effectively, promote your app’s new payments functionality.
• SDK 1.6: All new integrations should use this v2 version of the PayPal Here SDK. Existing partners looking for prior versions of this SDK are recommended to update to this version, but can find version 1.6 here.