Accept a PayPal payment
Learn how to accept PayPal payment, a digital wallet popular with businesses in Europe.
Set up StripeServer-sideClient-side
First, you need a Stripe account. Register now.
Server-side
This integration requires endpoints on your server that talk to the Stripe API. Use the official libraries for access to the Stripe API from your server:
Client-side
The Stripe Android SDK is open source and fully documented.
To install the SDK, add stripe-android
to the dependencies
block of your app/build.gradle file:
Note
For details on the latest SDK release and past versions, see the Releases page on GitHub. To receive notifications when a new release is published, watch releases for the repository.
Configure the SDK with your Stripe publishable key so that it can make requests to the Stripe API, such as in your Application
subclass:
Note
Stripe samples also use OkHttp and GSON to make HTTP requests to a server.
Create a PaymentIntentServer-sideClient-side
Server-side
Stripe uses a payment object, called a PaymentIntent, to track and handle all the states of the payment until it’s completed. Create a PaymentIntent
on your server, specifying the amount to collect and the currency. If you already have an integration using the Payment Intents API, add paypal
to the list of payment method types for your PaymentIntent.
Included in the returned PaymentIntent is a client secret, which is used to securely complete the payment process instead of passing the entire PaymentIntent object. Send the client secret back to the client so you can use it in later steps.
Include a custom description
By default, the order details on the PayPal users purchase activity page displays the order amount. You can change this by providing a custom description in the description
property.
Customize the preferred locale
By default, the PayPal authorisation page is localised based on variables such as the merchant’s country. You can set this to your customer’s preferred locale using the preferred_
property. The value must be a two-character lowercased language code, followed by a hyphen (-
), followed by a two-character uppercased country code. For example, the value for a French-language user in Belgium would be fr-BE
. See supported locales for more information.
Statement descriptors with PayPal
The descriptor that appears on the buyer’s bank statement is set by PayPal, and by default is PAYPAL *YOUR_
. If you set the statement_
field when creating the PaymentIntent
, its value is appended to the one set by PayPal, up to a total limit of 22 characters.
For example, if your business name in PayPal is BUSINESS
and you set statement_
to order_
, buyers see PAYPAL *BUSINESS order
on their bank account statement.
Client-side
On the client, request a PaymentIntent from your server and store its client secret.
Submit the payment to StripeClient-side
Retrieve the client secret from the SetupIntent you created and call PaymentLauncher confirm. This presents a webview where the customer can complete the setup on their bank’s website or app. Afterwards, onPaymentResult
is called with the result of the payment.
You can find the payment owner’s name, email address, payer ID, and transaction ID in the payment_method_details property.
Field | Value |
---|---|
payer_ | The email address of the payer on their PayPal account. |
payer_ | The name of the payer on their PayPal account. |
payer_ | A unique ID of the payer’s PayPal account. |
transaction_ | A unique transaction ID generated by PayPal. |
{ "charges": { "data": [ { "payment_method_details": { "paypal": { "payer_id": "H54KFE9XXVVYJ", "payer_email": "jenny@example.com", "payer_name": "Jenny Rosen", "transaction_id": "89W40396MK104212M" }, "type": "paypal" }, "id": "src_16xhynE8WzK49JbAs9M21jaR", "object": "source", "amount": 1099, "client_secret": "src_client_secret_UfwvW2WHpZ0s3QEn9g5x7waU", "created": 1445277809, "currency": "eur", "flow": "redirect",