{"id":19888894,"url":"https://github.com/paypal/paypal-here-sdk-ios-distribution","last_synced_at":"2025-07-31T02:13:59.762Z","repository":{"id":1117285,"uuid":"8415127","full_name":"paypal/paypal-here-sdk-ios-distribution","owner":"paypal","description":"Add credit card (tap, insert, swipe \u0026 key-in) capabilities to your iOS app","archived":false,"fork":false,"pushed_at":"2022-04-20T20:30:11.000Z","size":2142744,"stargazers_count":82,"open_issues_count":28,"forks_count":73,"subscribers_count":44,"default_branch":"master","last_synced_at":"2025-02-09T04:51:27.472Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-02-25T18:23:33.000Z","updated_at":"2025-01-02T04:21:36.000Z","dependencies_parsed_at":"2022-08-06T10:15:28.588Z","dependency_job_id":null,"html_url":"https://github.com/paypal/paypal-here-sdk-ios-distribution","commit_stats":null,"previous_names":["paypal-mobile/ios-here-sdk-dist"],"tags_count":147,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2Fpaypal-here-sdk-ios-distribution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2Fpaypal-here-sdk-ios-distribution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2Fpaypal-here-sdk-ios-distribution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paypal%2Fpaypal-here-sdk-ios-distribution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paypal","download_url":"https://codeload.github.com/paypal/paypal-here-sdk-ios-distribution/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240557488,"owners_count":19820358,"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","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-11-12T18:08:35.340Z","updated_at":"2025-02-24T20:54:35.240Z","avatar_url":"https://github.com/paypal.png","language":"Objective-C","funding_links":["https://www.paypal.com/webapps/mpp/credit-card-reader","https://www.paypal.com/merchantapps/appcenter/acceptpayments","https://www.paypal.com/au/webapps/mpp/paypal-here-faq?locale.x=en_AU","https://developer.paypal.com/docs/integration/paypal-here/","https://www.paypal.com/us/webapps/mpp/credit-card-reader-how-to/mobile-card-reader","https://developer.paypal.com/docs/integration/paypal-here/merchant-onboarding/","https://www.paypal.com/us/webapps/mpp/credit-card-reader-how-to/chip-card-reader"],"categories":[],"sub_categories":[],"readme":"Introduction\n=================\nThe PayPal Here SDK enables iOS apps to process in-person credit card transactions using an assortment of [card readers](https://www.paypal.com/webapps/mpp/credit-card-reader#A39) that are capable of accepting contactless, EMV, and swipe payment methods.\n\nDevelopers should use the PayPal Here SDK to get world-class payment processing with one simple integration.  Some of the main benefits include\n* **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.\n* **Safety \u0026 Security:** PayPal's solution uses encrypted swipers, such that card data is never made available to merchants or anyone else.\n* **Live customer support:** Whenever you need support, we’re available to help with our customer support team.\n[Visit our website](https://www.paypal.com/webapps/mpp/credit-card-reader) for more information about PayPal Here.\n* **Partner program:** Please [contact us](https://www.paypal-business.com/SDKdeveloperinterestregistration) for any partnership program questions or opportunities.\n\n\u003e **Note:** From 1 July 2021 AEST, PayPal Here services (including both the credit card reader devices and the PayPal Here App) will no longer be available in Australia. This means you will not be able to accept payments through PayPal Here with the credit card reader device or via the PayPal Here App from that date. We have also ceased the sale of new PayPal Here credit card reader devices. If you are looking for a card payment solution, please see [here](https://www.paypal.com/merchantapps/appcenter/acceptpayments). If you are an existing PayPal Here customer and have any questions, please click [here](https://www.paypal.com/au/webapps/mpp/paypal-here-faq?locale.x=en_AU).\n\n\nSupporting Materials\n========================\n *  PPH SDK documentation can be found [here](https://developer.paypal.com/docs/integration/paypal-here/).\n *  PPH SDK class reference can be found [here](http://paypal.github.io/paypal-here-sdk-ios-distribution/).\n *  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.\n\n\nInstallation\n==============\nOur recommended installation method is Cocoapods - `pod 'PayPalHereSDKv2'`\n\nThe default installation is the Debug build but you can switch to the Release build of the PayPalHereSDK by using the Release subspec - `pod 'PayPalHereSDKv2/Release'`\n\nAs a side note, please make sure you also add `com.paypal.here.reader` to the Supported External Accessory Protocols entry of your app's `.plist` file. If you're processing with the [Mobile Card Reader](https://www.paypal.com/us/webapps/mpp/credit-card-reader-how-to/mobile-card-reader), you'll also need to add a description for Microphone usage within your `.plist` file.\n\n\nHousekeeping Items\n=====================\nThere are a few noteworthy items that should be called out. These include:\n* **Auth/Capture:** Please note that auth/capture processing is currently only available for the US and UK.\n* **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.\n* **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](https://developer.paypal.com/docs/integration/paypal-here/merchant-onboarding/)\n* **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. \n* **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](https://github.com/paypal/paypal-here-sdk-ios-distribution/tree/PayPalHereSdkv1.6).\n\n\nApp Review Information\n======================\nOnly the Release build of the PayPal Here SDK is eligible for App Store release. If you submit your app for approval with the Debug build, your app will be rejected. To install the release build with Cocoapods please use:\n`pod 'PayPalHereSDKv2/Release'`\n\nWhen you submit your app, if you are using the [Chip Card Reader](https://www.paypal.com/us/webapps/mpp/credit-card-reader-how-to/chip-card-reader), you will need to enroll in the [Apple MFi program](https://mfi.apple.com/MFiWeb/getFAQ.action). In order to complete your enrollment, please complete the [MFi Enrollment Form](/docs/MFi-Enrollment.xls) and email it to \u003cpph-sdk@paypal.com\u003e. Please note that this process can take a few days to complete.\n\nBe sure to include the following into your app store review notes:\n* This iOS application uses the Bluetooth protocol \"com.paypal.here.reader\": PPID# 126754-0002 \u0026 PPID# 126754-0026\n\n\nKeep the app connected to the reader when the app goes to background\n====================================================================\n\nHere’s what will make the Bluetooth readers stay connected to a sample/partner app when the app is backgrounded (till the OS decides to kill the app)\n\nProject -\u003e Capabilities -\u003e Background Modes -\u003e ON \n\nEnable/Check\n* External accessory communication\n* Uses Bluetooth LE accessories\n* Act as a Bluetooth LE accessory\n\n[License](LICENSE.md)\n=======\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaypal%2Fpaypal-here-sdk-ios-distribution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaypal%2Fpaypal-here-sdk-ios-distribution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaypal%2Fpaypal-here-sdk-ios-distribution/lists"}