In-App Purchases (macOS)

Preparing

Paid Applications Agreement

If you haven’t already, you’ll need to sign the Paid Applications Agreement and set up your banking and tax information in iTunes Connect.

iTunes Connect Developer Help: Agreements, tax, and banking overview

Create Your In-App Purchases

Then, you’ll need to configure your in-app purchases in iTunes Connect, and include details such as name, pricing, and description that highlights the features and functionality of your in-app purchase.

iTunes Connect Developer Help: Create an in-app purchase

Change the CFBundleIdentifier

To test In-App Purchase in development with Electron you’ll have to change the CFBundleIdentifier in node_modules/electron/dist/Electron.app/Contents/Info.plist. You have to replace com.github.electron by the bundle identifier of the application you created with iTunes Connect.

  1. <key>CFBundleIdentifier</key>
  2. <string>com.example.app</string>

Code example

Here is an example that shows how to use In-App Purchases in Electron. You’ll have to replace the product ids by the identifiers of the products created with iTunes Connect (the identifier of com.example.app.product1 is product1). Note that you have to listen to the transactions-updated event as soon as possible in your app.

  1. // Main process
  2. const { inAppPurchase } = require('electron')
  3. const PRODUCT_IDS = ['id1', 'id2']
  5. // Listen for transactions as soon as possible.
  6. inAppPurchase.on('transactions-updated', (event, transactions) => {
  7.   if (!Array.isArray(transactions)) {
  8.     return
  9.   }
  11.   // Check each transaction.
  12.   transactions.forEach((transaction) => {
  13.     const payment = transaction.payment
  15.     switch (transaction.transactionState) {
  16.       case 'purchasing':
  17.         console.log(`Purchasing ${payment.productIdentifier}...`)
  18.         break
  20.       case 'purchased': {
  21.         console.log(`${payment.productIdentifier} purchased.`)
  23.         // Get the receipt url.
  24.         const receiptURL = inAppPurchase.getReceiptURL()
  26.         console.log(`Receipt URL: ${receiptURL}`)
  28.         // Submit the receipt file to the server and check if it is valid.
  29.         // @see https://developer.apple.com/library/content/releasenotes/General/ValidateAppStoreReceipt/Chapters/ValidateRemotely.html
  30.         // ...
  31.         // If the receipt is valid, the product is purchased
  32.         // ...
  34.         // Finish the transaction.
  35.         inAppPurchase.finishTransactionByDate(transaction.transactionDate)
  37.         break
  38.       }
  40.       case 'failed':
  42.         console.log(`Failed to purchase ${payment.productIdentifier}.`)
  44.         // Finish the transaction.
  45.         inAppPurchase.finishTransactionByDate(transaction.transactionDate)
  47.         break
  48.       case 'restored':
  50.         console.log(`The purchase of ${payment.productIdentifier} has been restored.`)
  52.         break
  53.       case 'deferred':
  55.         console.log(`The purchase of ${payment.productIdentifier} has been deferred.`)
  57.         break
  58.       default:
  59.         break
  60.     }
  61.   })
  62. })
  64. // Check if the user is allowed to make in-app purchase.
  65. if (!inAppPurchase.canMakePayments()) {
  66.   console.log('The user is not allowed to make in-app purchase.')
  67. }
  69. // Retrieve and display the product descriptions.
  70. inAppPurchase.getProducts(PRODUCT_IDS).then(products => {
  71.   // Check the parameters.
  72.   if (!Array.isArray(products) || products.length <= 0) {
  73.     console.log('Unable to retrieve the product informations.')
  74.     return
  75.   }
  77.   // Display the name and price of each product.
  78.   products.forEach(product => {
  79.     console.log(`The price of ${product.localizedTitle} is ${product.formattedPrice}.`)
  80.   })
  82.   // Ask the user which product he/she wants to purchase.
  83.   const selectedProduct = products[0]
  84.   const selectedQuantity = 1
  86.   // Purchase the selected product.
  87.   inAppPurchase.purchaseProduct(selectedProduct.productIdentifier, selectedQuantity).then(isProductValid => {
  88.     if (!isProductValid) {
  89.       console.log('The product is not valid.')
  90.       return
  91.     }
  93.     console.log('The payment has been added to the payment queue.')
  94.   })
  95. })