Skip to content

Conversation

@nirvan543
Copy link

Reason for changes

This PR contains the integration guides for the PayPal iOS SDK. Each integration guide explains how to implement an end-to-end integration (app + server).

Summary of changes

  • Addition of the PAYPAL_CHECKOUT_INTEGRATION_GUIDE.md

Checklist

  • Added a changelog entry (will do after the draft is done)

Authors

List GitHub usernames for everyone who contributed to this pull request.

In order to get the most out of this guide, it’s important to first understand the PayPal checkout process.

> PayPal checkout utilizes the [Orders API](https://developer.paypal.com/docs/api/orders/v2/) to create and manage a PayPal Order. An Order represents a payment between two or more parties; and with it, you can manage your customer’s transaction. It is the fundamental object used for managing checkout on PayPal’s platform. For more information on Orders and how to use the API, please refer to the [Orders API reference](https://developer.paypal.com/docs/api/orders/v2/).

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice description

- `CorePayments`
- `PaymentButtons`

**Option 2: Cocoapods**
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we mention the deprecation, or is that something you think devs should know?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about that but I didn't put that information in there because we didn't have an official stance/plan on it yet. Let's talk about our plan for Cocoapods and then we can add it in here.

@KunJeongPark
Copy link
Collaborator

KunJeongPark commented Jul 3, 2025

Very comprehensive. I'm wondering if it's a bit overwhelming as a single document. I know we have official docs in the works
but is there a way we can have separate files for server SDK integration, sample integration.
We can also try out details tags that can be expanded.

We are already linking out to demo apps also.

@nirvan543
Copy link
Author

Very comprehensive. I'm wondering if it's a bit overwhelming as a single document. I know we have official docs in the works but is there a way we can have separate files for server SDK integration, sample integration. We can also try out details tags that can be expanded.

We are already linking out to demo apps also.

You're right about it being a lot. I thought about breaking this doc up into smaller docs that get linked out but I felt if we did that, the flow of the integration guide would be broken up and be a bit disjointed.

With that said, when we add integration guides for the other payment methods (ex: ACDC), there will be duplication of docs that can be avoided if we break up the docs. It's a matter of balancing integration experience and duplication. Right now, I'm leaning on the side of accepting the duplication to improve the integration docs experience.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants