/wecrowd-ios

A demo iOS app showing how to consume the wepay-ios SDK.

Primary LanguageObjective-CMIT LicenseMIT

WeCrowd iOS

WeCrowd logo

Overview

Native application for WeCrowd, a sample crowdfunding platform that showcases easy payment transactions courtesy of the WePay iOS SDK and API. Note that WeCrowd does not actually process any payments.

What the app is for

  • The app demonstrates donation flow from two perspectives: a merchant and a payer. A merchant can accept donations via a card swiper or [virtual terminal] (https://en.wikipedia.org/wiki/Virtual_terminal). A virtual terminal is basically a way for someone (presumably a merchant) to enter credit card information on behalf of someone else (presumably a payer).
  • The app is meant to be an implementation guide of sorts for platforms integrating the WePay iOS SDK. Best iOS practices have been used as much as possible.

What the app is NOT for

  • This app does not perform actual transactions or donate to any real causes.
  • This app is not meant to be a full-fledged version of the WeCrowd web app. Some functionality (such as creating a campaign as a merchant) is not implemented since the primary goal of the app is to showcase the payment trasaction flow.

External code used

Huge shout out to these awesome open source pods!

Usage Instructions

  1. Clone the repo
  2. Change to the repo root directory (i.e. wepay-wecrowd-mobile-ios) -- $ cd ./wepay-wecrowd-mobile-ios/
  3. Ensure CocoaPods is installed and up to date
  4. Run a $ pod install from the commandline
  5. Ensure XCode is installed -- can be installed from the App Store
  6. Ensure the command line tools are installed -- $ xcode-select --install
  7. Open the WeCrowd.xcworkspace file as pod instructs -- $ open ./WeCrowd.xcworkspace/
  8. Run the app on your favorite iOS device!

License

See the [LICENSE] (LICENSE.md) file for license rights and limitations (MIT).