Buy Me a Coffee is a modern creator platform. It takes two minutes to start your page and has all the features that you need to build your creative business.
Donations 💰
Give your audience a friendly way to thank you.
Memberships 🗓️
Earn recurring revenue by offering a monthly or yearly membership.
Sell Extras ✨
A new, creative way to offer Zoom calls, art commissions, anything.
- Apple Pay
- iCloud Keychain
CocoaPods | Swift Package Manager |
---|---|
Swift 5.0 | Swift 5.3 |
Xcode 11.x | Xcode 12.x |
These are the two App Store Review Guidelines articles you have to know before using this framework:
- Apps may use in-app purchase currencies to enable customers to “tip” digital content providers in the app.
(vii) Apps may enable individual users to give a monetary gift to another individual without using in-app purchase, provided that (a) the gift is a completely optional choice by the giver, and (b) 100% of the funds go to the receiver of the gift. However, a gift that is connected to or associated at any point in time with receiving digital content or services must use in-app purchase.
- Import the BuyMeACoffee framework in your
UIApplicationDelegate
:
import BuyMeACoffee
- Configure the
BMCManager
shared instance with the username you've chosen on www.buymeacoffee.com, typically in your app'sapplication:didFinishLaunchingWithOptions:
method:
BMCManager.shared.configure(username: "appcraftstudio")
- In the view controller, override the
viewDidLoad
method to set the presenting view controller of theBMCManager
object.
BMCManager.shared.presentingViewController = self
// You can also set a custom thank you message
BMCManager.shared.thankYouMessage = "Thank you for supporting 🎉 App Craft Studio !"
- Add a
BMCButton
to your storyboard, XIB file, or instantiate it programmatically. To add the button to your storyboard or XIB file, add a View and set its custom class toBMCButton
. - Optional: If you want to customize the button, do the following:
let configuration = BMCButton.Configuration(color: .orange, font: .cookie)
let button = BMCButton(configuration: configuration)
// or set the burtton configuration later
button.configure(with: configuration)
Depending the legal receiver of the gift configured on Buy Me a Coffee, App Store reviewers can ask for In-App Purchase implementation.
If the following In-App Purchase if configured for your application, it will be displayed as primary flow when user tap on the BMCButton
.
If the framework can't retrieve In-App Purchase informations, the web flow will be used as fallback.
Go to App Store Connect, search for the In-App Purchases section of your app, and then, create a new one with the following informations:
Type | Consumable |
Reference Name | Buy Me a Coffee |
Product ID | your.app.bundle.identifier .buymeacoffee |
Cleared for Sale | ✅ |
Price | Tier 4 |
Display Name | Buy Me a Coffee |
Description | Hey there! You can now buy me a coffee! |
Promotional Image | download here |
Review Screenshot | download here |
Review Notes | Buy Me a Coffee enable customers to “tip” digital content providers in the app. |
- Select the current workspace in the project navigator.
- Then, select the app target in the left panel.
- Go to the Signing & Capabilities tab.
- Add the In-App Purchase capability.
You want to add pod 'BuyMeACoffee', '~> 1.0'
similar to the following to your Podfile:
target 'MyApp' do
pod 'BuyMeACoffee', '~> 1.0'
end
Then run a pod install
inside your terminal, or from CocoaPods.app.
- Using Xcode 11 or above go to File > Swift Packages > Add Package Dependency
- Paste the project URL: https://github.com/appcraftstudio/buymeacoffee.git
- Click on next and select the project target
Copyright © 2020 App Craft Studio. All rights reserved.