{"id":1777,"url":"https://github.com/paypal/PayPal-iOS-SDK","last_synced_at":"2025-08-02T23:33:01.069Z","repository":{"id":7027814,"uuid":"8301168","full_name":"paypal/PayPal-iOS-SDK","owner":"paypal","description":"Accept credit cards and PayPal in your iOS app","archived":true,"fork":false,"pushed_at":"2019-01-15T23:37:48.000Z","size":784772,"stargazers_count":980,"open_issues_count":0,"forks_count":371,"subscribers_count":116,"default_branch":"master","last_synced_at":"2025-07-27T09:05:07.086Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paypal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-02-19T22:40:39.000Z","updated_at":"2025-07-14T15:35:51.000Z","dependencies_parsed_at":"2022-09-11T23:22:04.422Z","dependency_job_id":null,"html_url":"https://github.com/paypal/PayPal-iOS-SDK","commit_stats":null,"previous_names":[],"tags_count":96,"template":false,"template_full_name":null,"purl":"pkg:github/paypal/PayPal-iOS-SDK","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2FPayPal-iOS-SDK","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2FPayPal-iOS-SDK/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2FPayPal-iOS-SDK/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2FPayPal-iOS-SDK/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paypal","download_url":"https://codeload.github.com/paypal/PayPal-iOS-SDK/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2FPayPal-iOS-SDK/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268469882,"owners_count":24255366,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-01-05T20:15:55.575Z","updated_at":"2025-08-02T23:32:56.041Z","avatar_url":"https://github.com/paypal.png","language":"Objective-C","funding_links":["https://developer.paypal.com/docs/accept-payments/express-checkout/ec-braintree-sdk/get-started/","https://developer.paypal.com/webapps/developer/docs/integration/mobile/verify-mobile-payment/","https://developer.paypal.com/webapps/developer/docs/integration/direct/capture-payment/","https://developer.paypal.com/webapps/developer/docs/integration/direct/create-process-order/","https://developer.paypal.com/developer/applications/","https://developer.paypal.com/webapps/developer/applications/accounts","https://developer.paypal.com/webapps/developer/docs/integration/direct/rest_api_payment_country_currency_support/","https://developer.paypal.com/docs"],"categories":["Official","官方的","SDK","Payments","Objective-C  Stars 1000以内排名整理","IOS","Objective-C"],"sub_categories":["Official","Other free courses","Other Parsing"],"readme":"**Important**: PayPal Mobile SDKs are Deprecated. The APIs powering them will remain operational long enough for merchants to migrate, but the SDKs themselves will no longer be updated. Please use [Braintree Direct](https://www.braintreepayments.com/products/braintree-direct) in [supported countries](https://www.braintreepayments.com/country-selection). In other countries, use [Express Checkout](https://developer.paypal.com/docs/accept-payments/express-checkout/ec-braintree-sdk/get-started/) and choose the Braintree SDK integration option.\n\nPayPal iOS SDK\n==============\n\nThe PayPal iOS SDK makes it easy to add PayPal payments to mobile apps.\n\n![SDK screenshots](docs/sdk-screens.png)\n\n*This documentation is available in Japanese: [日本語のドキュメント](docs/ja/README.md).*\n\n\u003e### Note\n\u003e There are 4 static libraries that you should link when building your application. `libPayPalMobile.a`, `libCardIO.a`, `libopencv_core.a', and `libopencv_imgproc.a` are required for all of the SDK functionality.\n\u003e\n\u003e The current version of the PayPal iOS SDK was built using Xcode 8.3.2.\n\n## Contents\n\n- [Use Cases](#use-cases)\n- [Requirements](#requirements)\n- [Add the SDK to Your Project](#add-the-sdk-to-your-project)\n- [Credentials](#credentials)\n- [International Support](#international-support)\n- [Testing](#testing)\n- [Documentation](#documentation)\n- [Usability](#usability)\n- [Next Steps](#next-steps)\n\n\n## Use Cases\n\nThe SDK supports two use cases for making payments - **Single Payment** and **Future Payments** - and a third use case for obtaining information about the customer - **Profile Sharing**.\n\n\n### Single Payment\n\nReceive a one-time payment from a customer's PayPal account. This can be either (1) an **immediate** payment which your servers should subsequently **verify**, or (2) an **authorization** for a payment which your servers must subsequently **capture**, or (3) a payment for an **order** which your servers must subsequently **authorize** and **capture**:\n\n1. [Accept a Single Payment](docs/single_payment.md) and receive back a proof of payment.\n2. On your server, [Verify the Payment](https://developer.paypal.com/webapps/developer/docs/integration/mobile/verify-mobile-payment/), [Capture the Payment](https://developer.paypal.com/webapps/developer/docs/integration/direct/capture-payment/#capture-the-payment), or [Process the Order](https://developer.paypal.com/webapps/developer/docs/integration/direct/create-process-order/) (PayPal Developer site) using PayPal's API.\n\n*Note:* Direct Credit Card (DCC) payments are now deprecated in this SDK.  Please use [Braintree Payments](https://www.braintreepayments.com/), a PayPal Company, which is the easiest way to accept PayPal, credit cards, and many other payment methods.\n\n\n### Future Payments\n\nYour customer logs in to PayPal just one time and consents to future payments:\n\n1. [Obtain Customer Consent](docs/future_payments_mobile.md#obtain-customer-consent) to receive an authorization code.\n2. On your server, use this authorization code to [Obtain OAuth2 Tokens](docs/future_payments_server.md#obtain-oauth2-tokens).\n\nLater, when that customer initiates a payment:\n\n1. [Obtain a Client Metadata ID](docs/future_payments_mobile.md#obtain-an-application-correlation-id) that you'll pass to your server.\n2. On your server, [Create a Payment](docs/future_payments_server.md#create-a-payment) using your OAuth2 tokens, the Client Metadata ID, and PayPal's API.\n\n\n### Profile Sharing\n\nYour customer logs in to PayPal and consents to PayPal sharing information with you:\n\n1. [Obtain Customer Consent](docs/profile_sharing_mobile.md#obtain-customer-consent) to receive an authorization code.\n2. On your server, use this authorization code to [Obtain OAuth2 Tokens](docs/profile_sharing_server.md#obtain-oauth2-tokens).\n3. On your server, [Retrieve Customer Information](docs/profile_sharing_server.md#retrieve-customer-information) using your OAuth2 tokens and PayPal's API.\n\n\n## Requirements\n\n* Xcode 8 and iOS SDK 10\n* iOS 7.0+ target deployment\n* armv7, armv7s, and arm64 devices, and the simulator (not armv6)\n* iPhone and iPad of all sizes and resolutions\n\n\n## Add the SDK to Your Project\n\n### If you use [CocoaPods](http://cocoapods.org), then add these lines to your podfile:\n\n```ruby\nplatform :ios, '7.0'\npod 'PayPal-iOS-SDK'\n```\n\n### If you don't use CocoaPods, then:\n\n1. Clone or download the SDK, which consists of header files, license acknowledgements, release notes, and a static library. It also includes a sample app.\n    * **As of version 2.17.0, the SDK requires Xcode 8 and iOS 10 SDK.**\n2. Add the `PayPalMobile` directory (containing several .h files and libPayPalMobile.a) to your Xcode project. We recommend checking \"Copy items...\" and selecting \"Create groups...\".\n3. In your project's **Build Settings** (in the `TARGETS` section, not the `PROJECTS` section):\n  * add `-lc++ -ObjC` to `Other Linker Flags`\n  * enable `Enable Modules (C and Objective-C)`\n  * enable `Link Frameworks Automatically`\n4. In your project's **Build Phases**, link your project with these libraries. Weak linking for iOS versions back to 6.0 is supported.\n  * `Accelerate.framework`\n  * `AudioToolbox.framework`\n  * `AVFoundation.framework`\n  * `CoreLocation.framework`\n  * `CoreMedia.framework`\n  * `MessageUI.framework`\n  * `MobileCoreServices.framework`\n  * `SystemConfiguration.framework`\n  * `SafariServices.framework`\n\n### With or without CocoaPods:\n\n1. Add the open source license acknowledgments from acknowledgments.md to [your app's acknowledgments](http://stackoverflow.com/questions/3966116/where-to-put-open-source-credit-information-for-an-iphone-app).\n2. In your app's Info.plist, add the following URL schemes to `LSApplicationQueriesSchemes`:\n  * `com.paypal.ppclient.touch.v1`\n  * `com.paypal.ppclient.touch.v2`\n  * `org-appextension-feature-password-management`\n\n## Credentials\n\nYour mobile integration requires different `client_id` values for each environment: Live and Test (Sandbox).\n\nYour server integrations for verifying or creating payments will also require the corresponding `client_secret` for each `client_id`.\n\nYou can obtain these PayPal API credentials by visiting the [Applications page on the PayPal Developer site](https://developer.paypal.com/developer/applications/) and logging in with your PayPal account.\n\n### Sandbox\n\nOnce logged in on this Applications page, you will be assigned **test credentials**, including Client ID, which will let you test your iOS integration against the PayPal Sandbox.\n\nWhile testing your app, when logging in to PayPal in the SDK's UI you should use a *personal* Sandbox account email and password. I.e., not your Sandbox *business* credentials.\n\nYou can create both business and personal Sandbox accounts on the [Sandbox accounts](https://developer.paypal.com/webapps/developer/applications/accounts) page.\n\n### Live\n\nTo obtain your **live** credentials, you will need to have a business account. If you don't yet have a business account, there is a link at the bottom of that same Applications page that will get you started.\n\n\n## International Support\n\n### Localizations\n\nThe SDK has built-in translations for many languages and locales. See the header files for a complete list.\n\n### Currencies\n\nThe SDK supports multiple currencies. See [the REST API country and currency documentation](https://developer.paypal.com/webapps/developer/docs/integration/direct/rest_api_payment_country_currency_support/) for a complete, up-to-date list.\n\nIf your app initiates a transaction with a currency that turns out to be unsupported for the user's selected payment type, then the SDK will display an error to the user and write a message to the console log.\n\n\n## Testing\n\nDuring development and testing, set the environment to Sandbox or NoNetwork/Mock mode, to avoid moving real money around. See the header files for more information.\n\n\n## Documentation\n\n* These docs in the SDK, which include an overview of usage, step-by-step integration instructions, and sample code.\n* The sample app included in this SDK.\n* Header files are thoroughly documented; refer to them as needed for extra details about any given property or parameter.\n* The [PayPal Developer Docs](https://developer.paypal.com/docs), which cover error codes and server-side integration instructions.\n\n\n## Support\n\nWhen opening an issue, please include the environment (live or sandbox), SDK version, and a `PayPal-Debug-ID`. The console log may have something like:\n\n```\nPayPal SDK: Request has failed with error: INTERNAL_SERVICE_ERROR - System error. Please try again later. (500) | PayPal Debug-ID: 463acd5lba23c [live, PayPal iOS SDK 2.14.1]\n```\n\nAdditionally, information about the types of devices (iPhone 6s Plus, iPhone 5), iOS version, and any non-standard settings would be helpful to provide.\n\nFor merchant-specific issues, you should use the [PayPal Merchant Technical Support site](https://www.paypal-techsupport.com) to open an issue.\n\nPlease do **not** post your client ID or secret in an issue.\n\n\n## Usability\n\nUser interface appearance and behavior is set within the library itself. For the sake of usability and user experience consistency, apps should not adjust appearance properties or attempt to modify the SDK's behavior beyond the documented methods in the provided headers.\n\nSpecifically, if you are using `UIAppearance` to modify the appearance of any UI elements in your app, you should reverse those changes prior to presenting our viewcontroller, and set them again after dismissing the viewcontroller.\n\n\n## Next Steps\n\nDepending on your use case, you can now:\n\n* [Accept a single payment](docs/single_payment.md)\n* [Obtain user consent](docs/future_payments_mobile.md) to [create future payments](docs/future_payments_server.md).\n* [Obtain user consent](docs/profile_sharing_mobile.md) to [retrieve customer information](docs/profile_sharing_server.md).\n\n## Contributing\n\nPlease read our [contributing guidelines](CONTRIBUTING.md) prior to submitting a Pull Request.\n\n## License\n\nPlease refer to this repo's [license file](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaypal%2FPayPal-iOS-SDK","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaypal%2FPayPal-iOS-SDK","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaypal%2FPayPal-iOS-SDK/lists"}