Skip to content
Add credit card (swipe & key-in) capabilities to your Android app
Java
Branch: master
Clone or download
Latest commit 194c618 Jul 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Marketing Toolkit Adding Marketing Toolkit to GitHub Jun 30, 2015
SampleApp Adding version definition in the properties May 28, 2019
docs invoiceService removed and updted the docs Mar 2, 2018
.gitignore fabric.properties to .gitignore May 30, 2018
LICENSE.md Update LICENSE.md Jan 24, 2018
README.md Update README.md Jan 17, 2019
VERSIONS Update VERSIONS Jul 13, 2019

README.md

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.

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.
You can’t perform that action at this time.