Skip to content

Latest commit

 

History

History
94 lines (80 loc) · 4.37 KB

MIGRATING.md

File metadata and controls

94 lines (80 loc) · 4.37 KB
Raw

Migration Guides

Migration from versions < 9.1.0

  • CustomerSession#getPaymentMethods() and CustomerSession#attachPaymentMethod() have been added
  • PaymentSessionData#getSelectedPaymentMethodId() is now PaymentSessionData#getPaymentMethod() and returns a PaymentMethod. See usage in the samplestore app's PaymentActivity.java.
  • Remove the following unused methods from PaymentConfiguration
    • getRequiredBillingAddressFields()
    • setRequiredBillingAddressFields()
    • getShouldUseSourcesForCards()
    • setShouldUseSourcesForCards()

Migration from versions < 9.0.0

  • minSdkVersion is now 19

  • AccountParams.createAccountParams() requires a AccountParams#BusinessType parameter

    // before
AccountParams.createAccountParams(
  true,
  createBusinessData()
);

// after, AccountParams.BusinessType is required

// for Individual entities
AccountParams.createAccountParams(
  true,
  BusinessType.Individual,
  createBusinessData()
);

// for Company entities
AccountParams.createAccountParams(
  true,
  BusinessType.Company,
  createBusinessData()
);

  • CustomerSession.initCustomerSession() now has a Context parameter. Related, CustomerSession public instance methods no longer have a Context parameter.

    // before
CustomerSession.initCustomerSession(ephemeralKeyProvider);
CustomerSession.getInstance().setCustomerShippingInformation(this, listener);

// after
CustomerSession.initCustomerSession(this, ephemeralKeyProvider);
CustomerSession.getInstance().setCustomerShippingInformation(listener);

  • PaymentIntent has been updated to reflect API version 2019-02-11

    • PaymentIntent.Status.RequiresSource is now PaymentIntent.Status.RequiresPaymentMethod
    • PaymentIntent.Status.RequiresSourceAction is now PaymentIntent.Status.RequiresAction
    • PaymentIntent.NextActionType.AuthorizeWithUrl has been removed
    • PaymentIntent#getNextSourceAction() is now PaymentIntent#getNextAction()
    • PaymentIntent#getAuthorizationUrl() is now PaymentIntent#getRedirectUrl()
    • PaymentIntent#requiresAction() has been added as a convenience
    • PaymentIntent#getStatus() now returns a PaymentIntent.Status enum value instead of a String

  • Address is now immutable and its setters have been removed. Use Address.Builder to create a new Address object.

Migrating from versions < 7.0.0

  • Remove Bitcoin source support because Stripe no longer processes Bitcoin payments
    • Sources can no longer have a "BITCOIN" source type. These sources will now be interpreted as "UNKNOWN".
    • You can no longer createBitcoinParams. Please use a different payment method.

Migrating from versions < 5.0.0

  • StripeApiHandler methods can no longer be called directly.
  • PaymentConfiguration now stores your public key and is depended upon for CustomerSession.
  • Many Utils classes have been migrated to package-private access.

Migrating from versions < 4.0.0

  • Instantiation of a Stripe object can no longer throw an AuthenticationException.
    • Any time you were instantiating a Stripe object in a try/catch block will be simplified.
    Stripe stripe;
try {
   stripe = new Stripe(mContext, MY_PUBLISHABLE_KEY);
} catch (AuthenticationException authEx) {
   // This never happens because you check your key.
}
    now becomes 
    Stripe stripe = new Stripe(mContext, MY_PUBLISHABLE_KEY);
  • Stripe#setDefaultPublishableKey(String key) has similarly been changed, and no longer needs to be wrapped.
  • Both methods can still throw an IllegalArgumentException if an invalid key is used, but as a runtime exception, that does not need to be wrapped.
  • AuthenticationException will now only be thrown if you attempt to create a Token or Source with an invalid key.