Bring your Own Payment Code

You can use Nami paywalls on-top of your own in-app purchase code or a third-party subscription management solution.

Developer Task

Send this doc to your development team

1. Register for Paywall Buy Sku Callbacks

When an end user wants to make a purchase from a Nami Paywall, register for a callback so your app code can start the purchase flow.

The callback will fire when the user is ready to buy and include the product sku information you need to transaction.

Use this approach if you have your own in-app purchase implementation or use a third-party solution for subscription management.

Swift

// Receive a callback when the end user is ready to make a purchase
// from a Nami paywall. Implement your purchase code here. by starting the purchase flow.
NamiPaywallManager.registerBuySkuHandler { sku in
    print("Start the purchase flow for App Store product: \(sku.storeId)")
}

Kotlin

// Receive a callback when the end user is ready to make a purchase
// from a Nami paywall. Implement your purchase code here.
NamiPaywallManager.registerBuySkuHandler { paywall, sku ->
    Log.d(LOG_TAG, "Start the purchase flow for Google Play/Amazon Appstore product: $skuRefId")
}

React Native

useEffect(() => {
  NamiPaywallManager.registerBuySkuHandler((sku) => {
    
    // Start your purchase flow   
    console.log(
      'buy sku handler - start purchase flow for sku:',
      sku.skuId,
    );
}

Flutter

// Coming soon

Unity

NamiPaywallManager.RegisterBuySkuHandler(buySkuCallback);

Roku

// Coming soon

2. Notify Nami of Successful Purchase

Once your billing implementation has successfully processed a user's purchase, let the Nami SDK know by calling this method.

Once received, the paywall view will be closed.

Swift

// Call this method to tell Nami the purchase, handled by you, was successful and the paywall
// should be closed. Additional parameters used to provide a more complete picture for paywall
// conversion metrics and analytics.

// Pass back the NamiSKU that was passed to you via NamiPurchaseManager.registerBuySkuHandler callback
// plus, some artifacts from the purchase from either StoreKit 1 or StoreKit 2

// StoreKit 2 Product & Transaction objects
NamiPaywallManager.buySkuComplete(sku: NamiSKU, product: Product, transaction: Transaction) 
                                  
// StoreKit 1 SKProduct & SKPaymentTransaction objects
NamiPaywallManager.buySkuComplete(sku: NamiSKU, product: SKProduct, transaction: SKPaymentTransaction)

// or pass in the individual data elements used by Nami, wrapped in a `NamiPurchaseSuccess` object
let purchaseSuccess = NamiPurchaseSuccess(product: sku, transactionID: transactionId, originalTransactionID: originalTransactionId, originalPurchaseDate: originalPurchaseDate, purchaseDate: purchaseDate, expiresDate: expirationDate, price: price, currencyCode: currency, locale: locale)
NamiPaywallManager.buySkuComplete(purchaseSuccess: purchaseSuccess)

Kotlin

// paywall, and skuRefId were passed to you via NamiPurchaseManager.registerBuySkuHandler
// purchase is the purchase object from Google Play Billing
NamiPaywallManager.buySkuComplete(paywallActivity, purchase, sku)
  
  
// or provided a NamiPurchaseSuccess.Google or NamiPurchaseSuccess.Amazon object  
NamiPaywallManager.buySkuComplete(paywallActivity, purchaseSuccess)

React Native

// Once purchase flow is complete:    
if (Platform.OS === 'ios' || Platform.isTVOS) {
  NamiPaywallManager.buySkuCompleteApple({
    product: sku,
    transactionID: '12345',
    originalTransactionID: '12345',
    originalPurchaseDate: 1684823428,
    purchaseDate: 1684823428,
    price: '120',
    currencyCode: 'USD',
    locale: 'US',
  });
} else if (Platform.OS === 'android') {
  if (Platform.constants.Manufacturer === 'Amazon') {
    NamiPaywallManager.buySkuCompleteAmazon({
      product: sku,
      purchaseDate: 1684823428,
      purchaseSource: 'CAMPAIGN',
      receiptId: '12345',
      localizedPrice: '120',
      userId: '12345',
      marketplace: '12345',
    });
  } else {
    NamiPaywallManager.buySkuCompleteGooglePlay({
      product: sku,
      purchaseDate: 1684823428,
      purchaseSource: 'CAMPAIGN',
      purchaseToken: '_token_',
      orderId: 'GPA.123.456.789',
    });
  }
}

Flutter

// Coming soon

Unity

// Coming soon

Roku

// Coming soon

Additional Documentation

See our SDK Reference