The document discusses an overview of PayPal's new Android SDK for making payments. It describes how to implement PayPal payments in an Android app using the SDK in just 10 minutes. Developers can allow users to pay with PayPal or accept credit cards directly in the app using card.io scanning technology. The steps covered include configuring the Android manifest, starting the PayPal service, creating payment objects, launching the payment process, and verifying payments on the server.

1. PayPal’s New Android SDK:
Kicking Ass With Payments
Tim Messerschmidt
Droidcon Paris 2013

2. This talk will be about
- What is PayPal?
- Log In with PayPal
- PayPal Android SDK

3. Who Am I?
Tim Messerschmidt,
Developer Evangelist
working for PayPal.
Android Developer
living in Berlin.
I ♥ Java, Ruby, CSS3,
HTML5 & JavaScript!

4. What is PayPal?

5. Enable
merchants to
sell online
What is PayPal?

6. Enable
customers to
buy online
What is PayPal?

7. Payment Scenario
Sender Receiver
Transaction

8. eCommerce
Sender Receiver
Transaction
Item /
Service

9. Secure
Easy
Fast
Requirements

10. 128m
active users
What is PayPal?

11. 193
countries & regions
What is PayPal?

12. 25
supported currencies
What is PayPal?

13. 80
localized websites
What is PayPal?

14. France
fully supported
What is PayPal?

16. Local Merchants
Big Mac Menu:
- Fries
- Ketchup
- Water
... keeping it healthy

17. Painless Payments for Droids
Tim Messerschmidt
Identity

18. Login with...
Google Facebook Twitter

19. ... or PayPal.
Login with...

20. Name
Email
Date of Birth
Locale
Time Zone
Address
Gender
Language
Phone Number
Verified Account
Creation Date
Your Identity

21. Log In via
PayPal in the
browser or a
WebView.

22. Log In with PayPal
Authorization &
Authentication

23. Log In with PayPal
OAuth 2.0 &
OpenID Connect

24. No need to (re-)enter
your password after
logging in
Seamless Checkout

25. Painless Payments for Droids
Tim Messerschmidt
Summarizing Identity

26. Painless Payments for Droids
Tim Messerschmidt
Money

27. Lots Of Money

28. Painless Payments for Droids
Tim Messerschmidt
Digital Goods

29. Physical Goods

30. Physical Goods

31. 2 ways
Backend or via SDK
Using PayPal

32. Android SDK
Sample App:
• Sell a football jersey
• Fast Checkout
• Nice Interface

33. Present the
product & allow
to purchase it
Android SDK

34. Allow to pay via
PayPal or Card
Android SDK

35. The user enters
his credentials:
• Email
• Password
Android SDK

36. The user needs
to confirm his
payment...
Android SDK

37. ... and will be
presented a
confirmation of
his purchase
afterwards.
Android SDK

38. That’s nice... BUT:
What if the user
doesn’t want to use
PayPal or doesn’t
have an account?

39. Accept credit
cards in your
application
manually or...
Android SDK

40. ... via image
recognition
technology in
your app!
Android SDK

42. Implementation
In 10 minutes
How-to

43. <!-- Hardware features -->
<uses-feature
android:name="android.hardware.camera”
android:required="false" />
<uses-feature
android:name="android.hardware.camera.autofocus”
android:required="false" />
<!–- Permissions -->
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission
android:name="android.permission.INTERNET" />
<!-- card.io scanning -->
<uses-permission
android:name="android.permission.CAMERA" />
<uses-permission
android:name="android.permission.VIBRATE" />
How-to
AndroidManifest.xml:

44. <!-- Hardware features -->
<uses-feature
android:name="android.hardware.camera”
android:required="false" />
<uses-feature
android:name="android.hardware.camera.autofocus”
android:required="false" />
<!–- Permissions -->
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission
android:name="android.permission.INTERNET" />
<!-- card.io scanning -->
<uses-permission
android:name="android.permission.CAMERA" />
<uses-permission
android:name="android.permission.VIBRATE" />
How-to
AndroidManifest.xml:

45. <!-- Hardware features -->
<uses-feature
android:name="android.hardware.camera”
android:required="false" />
<uses-feature
android:name="android.hardware.camera.autofocus”
android:required="false" />
<!–- Permissions -->
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission
android:name="android.permission.INTERNET" />
<!-- card.io scanning -->
<uses-permission
android:name="android.permission.CAMERA" />
<uses-permission
android:name="android.permission.VIBRATE" />
How-to
AndroidManifest.xml:

46. <!-- Hardware features -->
<uses-feature
android:name="android.hardware.camera”
android:required="false" />
<uses-feature
android:name="android.hardware.camera.autofocus”
android:required="false" />
<!–- Permissions -->
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission
android:name="android.permission.INTERNET" />
<!-- card.io scanning -->
<uses-permission
android:name="android.permission.CAMERA" />
<uses-permission
android:name="android.permission.VIBRATE" />
How-to
AndroidManifest.xml:

47. <service
android:name="com.paypal.android.sdk.payments.PayPalService"
android:exported="false"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.LoginActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentMethodActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentConfirmActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentCompletedActivity"/>
<activity
android:name="io.card.payment.CardIOActivity"
android:configChanges="keyboardHidden|orientation"/>
<activity
android:name="io.card.payment.DataEntryActivity"/>
How-to
AndroidManifest.xml:

48. <service
android:name="com.paypal.android.sdk.payments.PayPalService"
android:exported="false"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.LoginActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentMethodActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentConfirmActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentCompletedActivity"/>
<activity
android:name="io.card.payment.CardIOActivity"
android:configChanges="keyboardHidden|orientation"/>
<activity
android:name="io.card.payment.DataEntryActivity"/>
How-to
AndroidManifest.xml:

49. <service
android:name="com.paypal.android.sdk.payments.PayPalService"
android:exported="false"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.LoginActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentMethodActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentConfirmActivity"/>
<activity
android:name="com.paypal.android.sdk.payments.PaymentCompletedActivity"/>
<activity
android:name="io.card.payment.CardIOActivity"
android:configChanges="keyboardHidden|orientation"/>
<activity
android:name="io.card.payment.DataEntryActivity"/>
How-to
AndroidManifest.xml:

50. // Can be NO_NETWORK for OFFLINE, SANDBOX for TESTING and LIVE for PRODUCTION
private static final String CONFIG_ENVIRONMENT =
PaymentActivity.ENVIRONMENT_NO_NETWORK;
// note that these credentials will differ between live & sandbox environments.
private static final String CONFIG_CLIENT_ID =
"credential from developer.paypal.com";
// when testing in sandbox, this is likely the -facilitator email address.
private static final String CONFIG_RECEIVER_EMAIL =
"your@email.com";
How-to
Your Activity:
Define your credentials and Environment first.

51. // Can be NO_NETWORK for OFFLINE, SANDBOX for TESTING and LIVE for PRODUCTION
private static final String CONFIG_ENVIRONMENT =
PaymentActivity.ENVIRONMENT_NO_NETWORK;
// note that these credentials will differ between live & sandbox environments.
private static final String CONFIG_CLIENT_ID =
"credential from developer.paypal.com";
// when testing in sandbox, this is likely the -facilitator email address.
private static final String CONFIG_RECEIVER_EMAIL =
"your@email.com";
How-to
Your Activity:
Define your credentials and Environment first.

52. // Can be NO_NETWORK for OFFLINE, SANDBOX for TESTING and LIVE for PRODUCTION
private static final String CONFIG_ENVIRONMENT =
PaymentActivity.ENVIRONMENT_NO_NETWORK;
// note that these credentials will differ between live & sandbox environments.
private static final String CONFIG_CLIENT_ID =
"credential from developer.paypal.com";
// when testing in sandbox, this is likely the -facilitator email address.
private static final String CONFIG_RECEIVER_EMAIL =
"your@email.com";
How-to
Your Activity:
Define your credentials and Environment first.

53. // Can be NO_NETWORK for OFFLINE, SANDBOX for TESTING and LIVE for PRODUCTION
private static final String CONFIG_ENVIRONMENT =
PaymentActivity.ENVIRONMENT_NO_NETWORK;
// note that these credentials will differ between live & sandbox environments.
private static final String CONFIG_CLIENT_ID =
"credential from developer.paypal.com";
// when testing in sandbox, this is likely the -facilitator email address.
private static final String CONFIG_RECEIVER_EMAIL =
"your@email.com";
How-to
Your Activity:
Define your credentials and Environment first.

54. @Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// your code here
Intent intent = new Intent(this, PayPalService.class);
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startService(intent);
}
How-to
Your Activity:
Start the PayPal-Service in your onCreate( ) method

55. @Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// your code here
Intent intent = new Intent(this, PayPalService.class);
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startService(intent);
}
How-to
Your Activity:
Start the PayPal-Service in your onCreate( ) method

56. PayPalPayment thingToBuy =
new PayPalPayment(new BigDecimal(“59.99"), "USD", "Paris SG Jersey");
Intent intent = new Intent(this, PaymentActivity.class);
intent.putExtra(PaymentActivity.EXTRA_PAYMENT, thingToBuy);
intent.putExtra(PaymentActivity.EXTRA_PAYER_ID, "myPayer");
// Repeat passing the credentials
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startActivityForResult(intent, PAYMENT_REQUEST);
How-to
Your Activity:
Start the payment itself via a button or something similar

57. PayPalPayment thingToBuy =
new PayPalPayment(new BigDecimal(“59.99"), "USD", "Paris SG Jersey");
Intent intent = new Intent(this, PaymentActivity.class);
intent.putExtra(PaymentActivity.EXTRA_PAYMENT, thingToBuy);
intent.putExtra(PaymentActivity.EXTRA_PAYER_ID, "myPayer");
// Repeat passing the credentials
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startActivityForResult(intent, PAYMENT_REQUEST);
How-to
Your Activity:
Start the payment itself via a button or something similar

58. PayPalPayment thingToBuy =
new PayPalPayment(new BigDecimal(“59.99"), "USD", "Paris SG Jersey");
Intent intent = new Intent(this, PaymentActivity.class);
intent.putExtra(PaymentActivity.EXTRA_PAYMENT, thingToBuy);
intent.putExtra(PaymentActivity.EXTRA_PAYER_ID, "myPayer");
// Repeat passing the credentials
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startActivityForResult(intent, PAYMENT_REQUEST);
How-to
Your Activity:
Start the payment itself via a button or something similar

59. PayPalPayment thingToBuy =
new PayPalPayment(new BigDecimal(“59.99"), "USD", "Paris SG Jersey");
Intent intent = new Intent(this, PaymentActivity.class);
intent.putExtra(PaymentActivity.EXTRA_PAYMENT, thingToBuy);
intent.putExtra(PaymentActivity.EXTRA_PAYER_ID, "myPayer");
// Repeat passing the credentials
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startActivityForResult(intent, PAYMENT_REQUEST);
How-to
Your Activity:
Start the payment itself via a button or something similar

60. PayPalPayment thingToBuy =
new PayPalPayment(new BigDecimal(“59.99"), "USD", "Paris SG Jersey");
Intent intent = new Intent(this, PaymentActivity.class);
intent.putExtra(PaymentActivity.EXTRA_PAYMENT, thingToBuy);
intent.putExtra(PaymentActivity.EXTRA_PAYER_ID, "myPayer");
// Repeat passing the credentials
intent.putExtra(PaymentActivity.EXTRA_PAYPAL_ENVIRONMENT, CONFIG_ENVIRONMENT);
intent.putExtra(PaymentActivity.EXTRA_CLIENT_ID, CONFIG_CLIENT_ID);
intent.putExtra(PaymentActivity.EXTRA_RECEIVER_EMAIL, CONFIG_RECEIVER_EMAIL);
startActivityForResult(intent, PAYMENT_REQUEST);
How-to
Your Activity:
Start the payment itself via a button or something similar

61. @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (resultCode == Activity.RESULT_OK) {
PaymentConfirmation confirm =
data.getParcelableExtra(PaymentActivity.EXTRA_RESULT_CONFIRMATION);
if (confirm != null) {
verifyPayment(confirm);
}
} else if (resultCode == Activity.RESULT_CANCELED) {
// Show the user that this got canceled
} else if (resultCode == PaymentActivity.RESULT_PAYMENT_INVALID) {
// Check the docs ;)
}
}
How-to
Your Activity:
Check the result after the user used PayPal

62. @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (resultCode == Activity.RESULT_OK) {
PaymentConfirmation confirm =
data.getParcelableExtra(PaymentActivity.EXTRA_RESULT_CONFIRMATION);
if (confirm != null) {
verifyPayment(confirm);
}
} else if (resultCode == Activity.RESULT_CANCELED) {
// Show the user that this got canceled
} else if (resultCode == PaymentActivity.RESULT_PAYMENT_INVALID) {
// Check the docs ;)
}
}
How-to
Your Activity:
Check the result after the user used PayPal

63. @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (resultCode == Activity.RESULT_OK) {
PaymentConfirmation confirm =
data.getParcelableExtra(PaymentActivity.EXTRA_RESULT_CONFIRMATION);
if (confirm != null) {
verifyPayment(confirm);
}
} else if (resultCode == Activity.RESULT_CANCELED) {
// Show the user that this got canceled
} else if (resultCode == PaymentActivity.RESULT_PAYMENT_INVALID) {
// Check the docs ;)
}
}
How-to
Your Activity:
Check the result after the user used PayPal

64. @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (resultCode == Activity.RESULT_OK) {
PaymentConfirmation confirm =
data.getParcelableExtra(PaymentActivity.EXTRA_RESULT_CONFIRMATION);
if (confirm != null) {
verifyPayment(confirm);
}
} else if (resultCode == Activity.RESULT_CANCELED) {
// Show the user that this got canceled
} else if (resultCode == PaymentActivity.RESULT_PAYMENT_INVALID) {
// Check the docs ;)
}
}
How-to
Your Activity:
Check the result after the user used PayPal

65. @Override
public void onDestroy() {
stopService(new Intent(this, PayPalService.class));
super.onDestroy();
}
How-to
Your Activity:
Stop your service in the lifecycle’s onDestroy( ) method to make sure it ends nicely
and doesn’t use unneeded resources.

66. Your app needs to
communicate with
a server to verify
payments
Verifying Payments

67. Criteria to use to
verify payments:
bit.ly/19FIis6
Verifying Payments

68. {
"proof_of_payment": {
"rest_api": {
"state": "approved",
"payment_id": "API-PAYMENT-ID-1843"
}
},
"payment": {
"short_description": "Paris SG Jersey",
"amount": ”59.99",
"currency_code": "USD"
},
"client": {
"platform": "Android",
"paypal_sdk_version": "1.0.2",
"environment": "live",
"product_name": "PayPal Android SDK"
}
}
Verifying Payments
REST-API proof of payment: Adaptive Payments proof of payment:
{
"proof_of_payment": {
"adaptive_payment": {
"pay_key": "AP-70M68096ML426802W",
"payment_exec_status": "COMPLETED",
"timestamp": "2013-02-20T00:26:25Z",
"app_id": "APP-91B933855X481767M"
}
},
"payment": {
"short_description": "Paris SG Shirt",
"amount": "59.99",
"currency_code": "USD"
},
"client": {
"platform": "Android",
"paypal_sdk_version": "1.0.2",
"environment": "live",
"product_name": "PayPal Android SDK"
}
}

69. {
"proof_of_payment": {
"rest_api": {
"state": "approved",
"payment_id": "API-PAYMENT-ID-1843"
}
},
"payment": {
"short_description": "Paris SG Jersey",
"amount": ”59.99",
"currency_code": "USD"
},
"client": {
"platform": "Android",
"paypal_sdk_version": "1.0.2",
"environment": "live",
"product_name": "PayPal Android SDK"
}
}
Verifying Payments
REST-API proof of payment: Adaptive Payments proof of payment:
{
"proof_of_payment": {
"adaptive_payment": {
"pay_key": "AP-70M68096ML426802W",
"payment_exec_status": "COMPLETED",
"timestamp": "2013-02-20T00:26:25Z",
"app_id": "APP-91B933855X481767M"
}
},
"payment": {
"short_description": "Paris SG Shirt",
"amount": "59.99",
"currency_code": "USD"
},
"client": {
"platform": "Android",
"paypal_sdk_version": "1.0.2",
"environment": "live",
"product_name": "PayPal Android SDK"
}
}

70. Somebody did that
work for you:
bit.ly/19FHQde
Verifying Payments

71. Android Studio
Gradle doesn’t
support
bundling .so
files with your
apk yet

72. US only
Europe coming soon!
Important

73. Documentation
developer.paypal.com
Information

74. Open Source
GitHub.com/paypal
Information

75. Questions?

76. Thanks!
Tim Messerschmidt
@SeraAndroid
tmesserschmidt@paypal.com
SlideShare.com/paypal