@stripe/stripe-react-native 0.23.2 → 0.24.0

package/lib/module/types/PlatformPay.js.map

@@ -1 +1 @@
-{"version":3,"names":["ApplePaySheetErrorType","ContactField","InvalidShippingField","ApplePayMerchantCapability","ApplePayShippingType","BillingAddressFormat","ButtonType","ButtonStyle","PaymentType","IntervalUnit"],"sources":["PlatformPay.ts"],"sourcesContent":["import type { Result as Token } from './Token';\nimport type { Result as PaymentMethod } from './PaymentMethod';\nimport type { Result as PaymentIntent } from './PaymentIntent';\nimport type { Result as SetupIntent } from './SetupIntent';\nimport type { StripeError, PlatformPayError } from './Errors';\nimport type { ShippingContact as ApplePayShippingContact } from './ApplePay';\nimport type { IsSupportedParams } from './GooglePay';\n\nexport type ApplePaySheetError =\n  | {\n      errorType: ApplePaySheetErrorType.InvalidShippingAddress;\n      field: InvalidShippingField;\n      message?: string;\n    }\n  | {\n      errorType:\n        | ApplePaySheetErrorType.UnserviceableShippingAddress\n        | ApplePaySheetErrorType.InvalidCouponCode\n        | ApplePaySheetErrorType.ExpiredCouponCode;\n      message?: string;\n    };\n\nexport enum ApplePaySheetErrorType {\n  InvalidShippingAddress = 'InvalidShippingAddress',\n  UnserviceableShippingAddress = 'UnserviceableShippingAddress',\n  InvalidCouponCode = 'InvalidCouponCode',\n  ExpiredCouponCode = 'ExpiredCouponCode',\n}\n\nexport enum ContactField {\n  EmailAddress = 'emailAddress',\n  Name = 'name',\n  PhoneNumber = 'phoneNumber',\n  PhoneticName = 'phoneticName',\n  PostalAddress = 'postalAddress',\n}\n\nexport enum InvalidShippingField {\n  Street = 'street',\n  City = 'city',\n  SubAdministrativeArea = 'subAdministrativeArea',\n  State = 'state',\n  PostalCode = 'postalCode',\n  Country = 'country',\n  CountryCode = 'countryCode',\n  SubLocality = 'subLocality',\n}\n\nexport type ApplePayBaseParams = {\n  /** ISO 3166-1 alpha-2 country code where the transaction is processed. */\n  merchantCountryCode: string;\n  /** ISO 4217 alphabetic currency code. */\n  currencyCode: string;\n  /** The SDK accepts Amex, Mastercard, Visa, and Discover for Apple Pay by default. Set this property to enable other card networks, for example: [\"JCB\", \"barcode\", \"chinaUnionPay\"]. A full list of possible networks can be found at https://developer.apple.com/documentation/passkit/pkpaymentnetwork. */\n  additionalEnabledNetworks?: Array<string>;\n  /** The list of items that describe a purchase. For example: total, tax, discount, and grand total. */\n  cartItems: Array<CartSummaryItem>;\n  /** The list of fields that you need for a shipping contact in order to process the transaction. If provided, you must implement the PlatformPayButton component's `onShippingContactSelected` callback and call `updatePlatformPaySheet` from there.*/\n  requiredShippingAddressFields?: Array<ContactField>;\n  /** The list of fields that you need for a billing contact in order to process the transaction. */\n  requiredBillingContactFields?: Array<ContactField>;\n  /** An array of shipping method objects that describe the supported shipping methods. If provided, you must implement the PlatformPayButton component's `onShippingMethodSelected` callback and call `updatePlatformPaySheet` from there. */\n  shippingMethods?: Array<ShippingMethod>;\n  /** Set the payment capabilities you support. If set, 3DS is required. */\n  merchantCapabilities?: Array<ApplePayMerchantCapability>;\n  /** An optional value that indicates how to ship purchased items. Defaults to 'Shipping'.*/\n  shippingType?: ApplePayShippingType;\n  /** A list of two-letter ISO 3166 country codes for limiting payment to cards from specific countries or regions. */\n  supportedCountries?: Array<string>;\n};\n\nexport type ApplePayPaymentMethodParams = {\n  /** Set this value to true to display the coupon code field, or pass the 'couponCode' field to autofill with a coupon code. Defaults to false. If true, you must implement the PlatformPayButton component's `onCouponCodeEntered` callback and call `updatePlatformPaySheet` from there. */\n  supportsCouponCode?: boolean;\n  /** Set this value to autofill with a coupon code. If provided, you must implement the PlatformPayButton component's `onCouponCodeEntered` callback and call `updatePlatformPaySheet` from there. */\n  couponCode?: string;\n};\n\nexport enum ApplePayMerchantCapability {\n  /** Required. This value must be supplied. */\n  Supports3DS = 'supports3DS',\n  /** Optional. If present, only transactions that are categorized as credit cards are allowed. */\n  SupportsCredit = 'supportsCredit',\n  /** Optional. If present, only transactions that are categorized as debit cards are allowed. */\n  SupportsDebit = 'supportsDebit',\n}\n\n/** A type that indicates how to ship purchased items. */\nexport enum ApplePayShippingType {\n  /** Default. */\n  Shipping = 'shipping',\n  Delivery = 'delivery',\n  StorePickup = 'storePickup',\n  ServicePickup = 'servicePickup',\n}\n\nexport type GooglePayBaseParams = {\n  /**\n   * Set to true to run in a test environment with relaxed application / merchant requirements. This environment is suggested for early development and for easily testing SDK.\n      - Does not require the application to be uploaded to the Google Play Store.\n      - Does not require a Google Pay Developer Profile.\n      - It uses production data, but at the end of the transaction you will receive a fake and non chargeable payment credential.\n      - The user will see a warning message that the app is not recognized/verified.\n   */\n  testEnv: boolean;\n  /** ISO 3166-1 alpha-2 country code where the transaction is processed. */\n  merchantCountryCode: string;\n  /** ISO 4217 alphabetic currency code. */\n  currencyCode: string;\n  /** Your merchant name, displayed in the Google Pay sheet. */\n  merchantName?: string;\n  /** Set to true to request an email address. Defaults to false. */\n  isEmailRequired?: boolean;\n  /** Set to false if you don't support credit cards. Defaults to true. */\n  allowCreditCards?: boolean;\n  /** If true, Google Pay is considered \"available\" if the customer's Google Pay wallet has an existing payment method. Defaults to false. */\n  existingPaymentMethodRequired?: boolean;\n  /** Describes the configuration for billing address collection in the Google Pay sheet. */\n  billingAddressConfig?: {\n    /** Set to true if billing address is required for payment. Defaults to false. */\n    isRequired?: boolean;\n    /** Set to true if phone number is required for payment. Defaults to false. */\n    isPhoneNumberRequired?: boolean;\n    /** Defines what address fields to collect. Defaults to BillingAddressFormat.Min */\n    format?: BillingAddressFormat;\n  };\n};\n\nexport type GooglePayPaymentMethodParams = {\n  /** Total monetary value of the transaction. */\n  amount: number;\n  /** Describes the configuration for shipping address collection in the Google Pay sheet. */\n  shippingAddressConfig?: {\n    /** Set to true if shipping address is required for payment. Defaults to false. */\n    isRequired?: boolean;\n    /** Set to true if phone number is required for payment. Defaults to false. */\n    isPhoneNumberRequired?: boolean;\n    /** Set of ISO 3166-1 alpha-2 country code values of the countries where shipping is allowed. Defaults to all shipping address countries. */\n    allowedCountryCodes?: Array<string>;\n  };\n};\n\nexport enum BillingAddressFormat {\n  /** Collect name, street address, locality, region, country code, and postal code. */\n  Full = 'FULL',\n  /** Collect name, country code, and postal code (default). */\n  Min = 'MIN',\n}\n\nexport type PaymentMethodParams = {\n  /** Defines Google Pay behavior. Android only. */\n  googlePay?: GooglePayBaseParams & GooglePayPaymentMethodParams;\n  /** Defines Apple Pay behavior. iOS only. */\n  applePay?: ApplePayBaseParams & ApplePayPaymentMethodParams;\n};\n\nexport type ConfirmParams = {\n  /** Defines Google Pay behavior. Android only. */\n  googlePay?: GooglePayBaseParams;\n  /** Defines Apple Pay behavior. iOS only. */\n  applePay?: ApplePayBaseParams;\n};\n\nexport enum ButtonType {\n  /** A button with the Apple Pay or Google Pay logo only, useful when an additional call to action isn't needed. */\n  Default = 0,\n  /** A button useful for product purchases. */\n  Buy = 1,\n  /** A button useful for booking trips, flights, or other experiences. */\n  Book = 6,\n  /** A button useful for purchase experiences that include other payment buttons that start with “Check out”. */\n  Checkout = 5,\n  /** A button used by approved nonprofit organization that lets people make donations. */\n  Donate = 4,\n  /** A button useful for placing orders for such as like meals or flowers. */\n  Order = 11,\n  /** A button useful for purchasing a subscription such as a gym membership or meal-kit delivery service. */\n  Subscribe = 7,\n  /** iOS only. A button useful for prompting the user to set up a card. */\n  SetUp = 2,\n  /** iOS only. A button useful for paying bills or invoices. */\n  InStore = 3,\n  /** iOS only. A button useful for adding money to a card, account, or payment system.*/\n  Reload = 8,\n  /** iOS only. A button useful for adding money to a card, account, or payment system. */\n  AddMoney = 9,\n  /** iOS only. A button useful for adding money to a card, account, or payment system. */\n  TopUp = 10,\n  /** iOS only. A button useful for renting items such as cars or scooters. */\n  Rent = 12,\n  /** iOS only. A button useful supporting people give money to projects, causes, organizations, and other entities.*/\n  Support = 13,\n  /** iOS only. A button useful to help people contribute money to projects, causes, organizations, and other entities. */\n  Contribute = 14,\n  /** iOS only. A button useful useful for letting people tip for goods or services. */\n  Tip = 15,\n  /** iOS only. A button useful for general purchases. */\n  Continue = 16,\n  /** Android only. A button useful for general payments. */\n  Pay = 1000,\n  /** Android only. A plain white button with the Google Pay logo. Use when you show Google Pay as a payment option in your payment flows. */\n  GooglePayMark = 1001,\n}\n\n/** iOS only. */\nexport enum ButtonStyle {\n  /** A white button with black lettering. */\n  White = 0,\n  /** A white button with black lettering and a black outline. */\n  WhiteOutline = 1,\n  /** A black button with white lettering. */\n  Black = 2,\n  /** Default. A button that automatically changes its appearance when the user switches between Light Mode and Dark Mode. */\n  Automatic = 3,\n}\n\n/** iOS only. */\nexport type CartSummaryItem =\n  | DeferredCartSummaryItem\n  | ImmediateCartSummaryItem\n  | RecurringCartSummaryItem;\n\n/** iOS only. */\nexport enum PaymentType {\n  Deferred = 'Deferred',\n  Immediate = 'Immediate',\n  Recurring = 'Recurring',\n}\n\n/** iOS only. Use this type for a payment that occurs in the future, such as a pre-order. Only available on iOS 15 and up, otherwise falls back to ImmediateCartSummaryItem. */\nexport type DeferredCartSummaryItem = {\n  paymentType: PaymentType.Deferred;\n  /** The unix timestamp of the date, in the future, of the payment. Measured in seconds. */\n  deferredDate: number;\n  label: string;\n  amount: string;\n};\n\n/** iOS only. Use this type for payments that will occur immediately. */\nexport type ImmediateCartSummaryItem = {\n  paymentType: PaymentType.Immediate;\n  /** When creating items for estimates or charges whose final value is not yet known, set this to true. */\n  isPending?: boolean;\n  label: string;\n  amount: string;\n};\n\n/** iOS only. Use this type for payments that occur more than once, such as a subscription. Only available on iOS 15 and up, otherwise falls back to ImmediateCartSummaryItem.*/\nexport type RecurringCartSummaryItem = {\n  paymentType: PaymentType.Recurring;\n  /** The amount of time – in calendar units such as Day, Month, or Year – that represents a fraction of the total payment interval. For example, if you set the intervalUnit to 'Month' and intervalCount to 3, then the payment interval is three months.*/\n  intervalUnit: IntervalUnit;\n  /** The number of interval units that make up the total payment interval. For example, if you set the intervalUnit to 'Month' and intervalCount to 3, then the payment interval is three months.*/\n  intervalCount: number;\n  /** The unix timestamp of the start date. Measured in seconds. */\n  startDate?: number;\n  /** The unix timestamp of the end date. Measured in seconds. */\n  endDate?: number;\n  label: string;\n  amount: string;\n};\n\n/** iOS only. */\nexport enum IntervalUnit {\n  Minute = 'minute',\n  Hour = 'hour',\n  Day = 'day',\n  Month = 'month',\n  Year = 'year',\n}\n\n/** iOS only. */\nexport type ShippingMethod = {\n  /** A short, localized description. */\n  label: string;\n  /** The cost associated with this shipping option. */\n  amount: string;\n  /** When creating items for estimates or charges whose final value is not yet known, set this to true. */\n  isPending?: boolean;\n  /** A unique identifier for the shipping method. */\n  identifier: string;\n  /** A user-readable description of the shipping method. For example “Ships in 24 hours.” Don't repeat the content of the 'label' property. */\n  detail?: string;\n  /** The unix timestamp of the start date of the expected range of delivery or shipping dates for a package, or the time range when an item is available for pickup. Measured in seconds. */\n  startDate?: number;\n  /** The unix timestamp of the end date of the expected range of delivery or shipping dates for a package, or the time range when an item is available for pickup. Measured in seconds. */\n  endDate?: number;\n};\n\n/** iOS only. */\nexport type ShippingContact = ApplePayShippingContact;\n\n/** Android only. */\nexport type IsGooglePaySupportedParams = IsSupportedParams;\n\nexport type PaymentMethodResult =\n  | {\n      paymentMethod: PaymentMethod;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n\nexport type TokenResult =\n  | {\n      token: Token;\n      error?: undefined;\n    }\n  | {\n      token?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n\nexport type ConfirmPaymentResult =\n  | {\n      paymentIntent: PaymentIntent;\n      error?: StripeError<PlatformPayError>;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n\nexport type ConfirmSetupIntentResult =\n  | {\n      setupIntent: SetupIntent;\n      error?: StripeError<PlatformPayError>;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n"],"mappings":"iUAsBYA,uBAAsB,iEAAtBA,sBAAsB,EAAtBA,sBAAsB,oDAAtBA,sBAAsB,gEAAtBA,sBAAsB,0CAAtBA,sBAAsB,6CAAtBA,sBAAsB,kCAAtBA,sBAAsB,SAOtBC,aAAY,6CAAZA,YAAY,EAAZA,YAAY,gCAAZA,YAAY,gBAAZA,YAAY,8BAAZA,YAAY,gCAAZA,YAAY,qCAAZA,YAAY,wBAAZA,YAAY,SAQZC,qBAAoB,6DAApBA,oBAAoB,EAApBA,oBAAoB,oBAApBA,oBAAoB,gBAApBA,oBAAoB,kDAApBA,oBAAoB,kBAApBA,oBAAoB,4BAApBA,oBAAoB,sBAApBA,oBAAoB,8BAApBA,oBAAoB,iCAApBA,oBAAoB,gCAApBA,oBAAoB,SAyCpBC,2BAA0B,yEAA1BA,0BAA0B,EAA1BA,0BAA0B,8BAA1BA,0BAA0B,oCAA1BA,0BAA0B,qCAA1BA,0BAA0B,sCAA1BA,0BAA0B,SAU1BC,qBAAoB,6DAApBA,oBAAoB,EAApBA,oBAAoB,wBAApBA,oBAAoB,wBAApBA,oBAAoB,8BAApBA,oBAAoB,qCAApBA,oBAAoB,gCAApBA,oBAAoB,SAsDpBC,qBAAoB,6DAApBA,oBAAoB,EAApBA,oBAAoB,gBAApBA,oBAAoB,iBAApBA,oBAAoB,gCAApBA,oBAAoB,SAqBpBC,WAAU,yCAAVA,UAAU,EAAVA,UAAU,CAAVA,UAAU,yBAAVA,UAAU,CAAVA,UAAU,iBAAVA,UAAU,CAAVA,UAAU,mBAAVA,UAAU,CAAVA,UAAU,2BAAVA,UAAU,CAAVA,UAAU,uBAAVA,UAAU,CAAVA,UAAU,sBAAVA,UAAU,CAAVA,UAAU,6BAAVA,UAAU,CAAVA,UAAU,qBAAVA,UAAU,CAAVA,UAAU,yBAAVA,UAAU,CAAVA,UAAU,uBAAVA,UAAU,CAAVA,UAAU,2BAAVA,UAAU,CAAVA,UAAU,sBAAVA,UAAU,CAAVA,UAAU,oBAAVA,UAAU,CAAVA,UAAU,0BAAVA,UAAU,CAAVA,UAAU,gCAAVA,UAAU,CAAVA,UAAU,kBAAVA,UAAU,CAAVA,UAAU,4BAAVA,UAAU,CAAVA,UAAU,oBAAVA,UAAU,CAAVA,UAAU,2CAAVA,UAAU,sBAAVA,UAAU,SA0CVC,YAAW,2CAAXA,WAAW,EAAXA,WAAW,CAAXA,WAAW,qBAAXA,WAAW,CAAXA,WAAW,mCAAXA,WAAW,CAAXA,WAAW,qBAAXA,WAAW,CAAXA,WAAW,gCAAXA,WAAW,uBAAXA,WAAW,SAkBXC,YAAW,2CAAXA,WAAW,EAAXA,WAAW,wBAAXA,WAAW,0BAAXA,WAAW,6BAAXA,WAAW,uBAAXA,WAAW,SAwCXC,aAAY,6CAAZA,YAAY,EAAZA,YAAY,oBAAZA,YAAY,gBAAZA,YAAY,cAAZA,YAAY,kBAAZA,YAAY,mBAAZA,YAAY,wBAAZA,YAAY"}
+{"version":3,"names":["ApplePaySheetErrorType","ContactField","InvalidShippingField","PaymentRequestType","ApplePayMerchantCapability","ApplePayShippingType","BillingAddressFormat","ButtonType","ButtonStyle","PaymentType","IntervalUnit"],"sources":["PlatformPay.ts"],"sourcesContent":["import type { Result as Token } from './Token';\nimport type { Result as PaymentMethod } from './PaymentMethod';\nimport type { Result as PaymentIntent } from './PaymentIntent';\nimport type { Result as SetupIntent } from './SetupIntent';\nimport type { StripeError, PlatformPayError } from './Errors';\nimport type { ShippingContact as ApplePayShippingContact } from './ApplePay';\nimport type { IsSupportedParams } from './GooglePay';\n\nexport type ApplePaySheetError =\n  | {\n      errorType: ApplePaySheetErrorType.InvalidShippingAddress;\n      field: InvalidShippingField;\n      message?: string;\n    }\n  | {\n      errorType:\n        | ApplePaySheetErrorType.UnserviceableShippingAddress\n        | ApplePaySheetErrorType.InvalidCouponCode\n        | ApplePaySheetErrorType.ExpiredCouponCode;\n      message?: string;\n    };\n\nexport enum ApplePaySheetErrorType {\n  InvalidShippingAddress = 'InvalidShippingAddress',\n  UnserviceableShippingAddress = 'UnserviceableShippingAddress',\n  InvalidCouponCode = 'InvalidCouponCode',\n  ExpiredCouponCode = 'ExpiredCouponCode',\n}\n\nexport enum ContactField {\n  EmailAddress = 'emailAddress',\n  Name = 'name',\n  PhoneNumber = 'phoneNumber',\n  PhoneticName = 'phoneticName',\n  PostalAddress = 'postalAddress',\n}\n\nexport enum InvalidShippingField {\n  Street = 'street',\n  City = 'city',\n  SubAdministrativeArea = 'subAdministrativeArea',\n  State = 'state',\n  PostalCode = 'postalCode',\n  Country = 'country',\n  CountryCode = 'countryCode',\n  SubLocality = 'subLocality',\n}\n\nexport type ApplePayBaseParams = {\n  /** ISO 3166-1 alpha-2 country code where the transaction is processed. */\n  merchantCountryCode: string;\n  /** ISO 4217 alphabetic currency code. */\n  currencyCode: string;\n  /** The SDK accepts Amex, Mastercard, Visa, and Discover for Apple Pay by default. Set this property to enable other card networks, for example: [\"JCB\", \"barcode\", \"chinaUnionPay\"]. A full list of possible networks can be found at https://developer.apple.com/documentation/passkit/pkpaymentnetwork. */\n  additionalEnabledNetworks?: Array<string>;\n  /** The list of items that describe a purchase. For example: total, tax, discount, and grand total. */\n  cartItems: Array<CartSummaryItem>;\n  /** The list of fields that you need for a shipping contact in order to process the transaction. If provided, you must implement the PlatformPayButton component's `onShippingContactSelected` callback and call `updatePlatformPaySheet` from there.*/\n  requiredShippingAddressFields?: Array<ContactField>;\n  /** The list of fields that you need for a billing contact in order to process the transaction. */\n  requiredBillingContactFields?: Array<ContactField>;\n  /** An array of shipping method objects that describe the supported shipping methods. If provided, you must implement the PlatformPayButton component's `onShippingMethodSelected` callback and call `updatePlatformPaySheet` from there. */\n  shippingMethods?: Array<ShippingMethod>;\n  /** Set the payment capabilities you support. If set, 3DS is required. */\n  merchantCapabilities?: Array<ApplePayMerchantCapability>;\n  /** An optional value that indicates how to ship purchased items. Defaults to 'Shipping'.*/\n  shippingType?: ApplePayShippingType;\n  /** A list of two-letter ISO 3166 country codes for limiting payment to cards from specific countries or regions. */\n  supportedCountries?: Array<string>;\n};\n\nexport type ApplePayConfirmParams = {\n  /** A typical request is for a one-time payment. To support different types of payment requests, include a PaymentRequestType. Only supported on iOS 16 and up. */\n  request?:\n    | RecurringPaymentRequest\n    | AutomaticReloadPaymentRequest\n    | MultiMerchantRequest;\n};\n\nexport enum PaymentRequestType {\n  Recurring = 'Recurring',\n  AutomaticReload = 'AutomaticReload',\n  MultiMerchant = 'MultiMerchant',\n}\n\n/** Use this for a recurring payment, typically a subscription. */\nexport type RecurringPaymentRequest = {\n  type: PaymentRequestType.Recurring;\n  /** A description that you provide of the recurring payment and that Apple Pay displays to the user in the sheet. */\n  description: string;\n  /** A URL to a web page where the user can update or delete the payment method for the recurring payment. */\n  managementUrl: string;\n  /** The regular billing cycle for the payment, including start and end dates, an interval, and an interval count. */\n  billing: RecurringCartSummaryItem;\n  /** Same as the billing property, but use this if the purchase has a trial period. */\n  trialBilling?: RecurringCartSummaryItem;\n  /** A localized billing agreement that the sheet displays to the user before the user authorizes the payment. */\n  billingAgreement?: string;\n  /** A URL you provide to receive life-cycle notifications from the Apple Pay servers about the Apple Pay merchant token for the recurring payment.\n   * For more information about handling merchant token life-cycle notifications, see Receiving and handling merchant token notifications.\n   */\n  tokenNotificationURL?: string;\n};\n\n/** Use this for an automatic reload or refill payment, such as a store card top-up. */\nexport type AutomaticReloadPaymentRequest = {\n  type: PaymentRequestType.AutomaticReload;\n  /** A description that you provide of the recurring payment and that Apple Pay displays to the user in the sheet. */\n  description: string;\n  /** A URL to a web page where the user can update or delete the payment method for the recurring payment. */\n  managementUrl: string;\n  /** A short, localized description of the item. */\n  label: string;\n  /** This is the amount that is automatically applied to the account when the account balance drops below the threshold amount. */\n  reloadAmount: string;\n  /** The balance an account reaches before you apply the automatic reload amount. */\n  thresholdAmount: string;\n  /** A localized billing agreement that the sheet displays to the user before the user authorizes the payment. */\n  billingAgreement?: string;\n  /** A URL you provide to receive life-cycle notifications from the Apple Pay servers about the Apple Pay merchant token for the recurring payment.\n   * For more information about handling merchant token life-cycle notifications, see Receiving and handling merchant token notifications.\n   */\n  tokenNotificationURL?: string;\n};\n\n/** Use this to indicate payments for multiple merchants. */\nexport type MultiMerchantRequest = {\n  type: PaymentRequestType.MultiMerchant;\n  merchants: Array<{\n    /** The Apple Pay merchant identifier. */\n    merchantIdentifier: string;\n    /** An external identifier for the merchant. */\n    externalIdentifier: string;\n    /** The merchant’s display name that the Apple Pay server associates with the payment token. */\n    merchantName: string;\n    /** The merchant’s top-level domain that the Apple Pay server associates with the payment token. */\n    merchantDomain?: string;\n    /** The amount to authorize for the payment token. */\n    amount: string;\n  }>;\n};\n\nexport type ApplePayPaymentMethodParams = {\n  /** Set this value to true to display the coupon code field, or pass the 'couponCode' field to autofill with a coupon code. Defaults to false. If true, you must implement the PlatformPayButton component's `onCouponCodeEntered` callback and call `updatePlatformPaySheet` from there. */\n  supportsCouponCode?: boolean;\n  /** Set this value to autofill with a coupon code. If provided, you must implement the PlatformPayButton component's `onCouponCodeEntered` callback and call `updatePlatformPaySheet` from there. */\n  couponCode?: string;\n};\n\nexport enum ApplePayMerchantCapability {\n  /** Required. This value must be supplied. */\n  Supports3DS = 'supports3DS',\n  /** Optional. If present, only transactions that are categorized as credit cards are allowed. */\n  SupportsCredit = 'supportsCredit',\n  /** Optional. If present, only transactions that are categorized as debit cards are allowed. */\n  SupportsDebit = 'supportsDebit',\n}\n\n/** A type that indicates how to ship purchased items. */\nexport enum ApplePayShippingType {\n  /** Default. */\n  Shipping = 'shipping',\n  Delivery = 'delivery',\n  StorePickup = 'storePickup',\n  ServicePickup = 'servicePickup',\n}\n\nexport type GooglePayBaseParams = {\n  /**\n   * Set to true to run in a test environment with relaxed application / merchant requirements. This environment is suggested for early development and for easily testing SDK.\n      - Does not require the application to be uploaded to the Google Play Store.\n      - Does not require a Google Pay Developer Profile.\n      - It uses production data, but at the end of the transaction you will receive a fake and non chargeable payment credential.\n      - The user will see a warning message that the app is not recognized/verified.\n   */\n  testEnv: boolean;\n  /** ISO 3166-1 alpha-2 country code where the transaction is processed. */\n  merchantCountryCode: string;\n  /** ISO 4217 alphabetic currency code. */\n  currencyCode: string;\n  /** Your merchant name, displayed in the Google Pay sheet. */\n  merchantName?: string;\n  /** Set to true to request an email address. Defaults to false. */\n  isEmailRequired?: boolean;\n  /** Set to false if you don't support credit cards. Defaults to true. */\n  allowCreditCards?: boolean;\n  /** If true, Google Pay is considered \"available\" if the customer's Google Pay wallet has an existing payment method. Defaults to false. */\n  existingPaymentMethodRequired?: boolean;\n  /** Describes the configuration for billing address collection in the Google Pay sheet. */\n  billingAddressConfig?: {\n    /** Set to true if billing address is required for payment. Defaults to false. */\n    isRequired?: boolean;\n    /** Set to true if phone number is required for payment. Defaults to false. */\n    isPhoneNumberRequired?: boolean;\n    /** Defines what address fields to collect. Defaults to BillingAddressFormat.Min */\n    format?: BillingAddressFormat;\n  };\n};\n\nexport type GooglePayPaymentMethodParams = {\n  /** Total monetary value of the transaction. */\n  amount: number;\n  /** Describes the configuration for shipping address collection in the Google Pay sheet. */\n  shippingAddressConfig?: {\n    /** Set to true if shipping address is required for payment. Defaults to false. */\n    isRequired?: boolean;\n    /** Set to true if phone number is required for payment. Defaults to false. */\n    isPhoneNumberRequired?: boolean;\n    /** Set of ISO 3166-1 alpha-2 country code values of the countries where shipping is allowed. Defaults to all shipping address countries. */\n    allowedCountryCodes?: Array<string>;\n  };\n};\n\nexport enum BillingAddressFormat {\n  /** Collect name, street address, locality, region, country code, and postal code. */\n  Full = 'FULL',\n  /** Collect name, country code, and postal code (default). */\n  Min = 'MIN',\n}\n\nexport type PaymentMethodParams = {\n  /** Defines Google Pay behavior. Android only. */\n  googlePay?: GooglePayBaseParams & GooglePayPaymentMethodParams;\n  /** Defines Apple Pay behavior. iOS only. */\n  applePay?: ApplePayBaseParams & ApplePayPaymentMethodParams;\n};\n\nexport type ConfirmParams = {\n  /** Defines Google Pay behavior. Android only. */\n  googlePay?: GooglePayBaseParams;\n  /** Defines Apple Pay behavior. iOS only. */\n  applePay?: ApplePayBaseParams & ApplePayConfirmParams;\n};\n\nexport enum ButtonType {\n  /** A button with the Apple Pay or Google Pay logo only, useful when an additional call to action isn't needed. */\n  Default = 0,\n  /** A button useful for product purchases. */\n  Buy = 1,\n  /** A button useful for booking trips, flights, or other experiences. */\n  Book = 6,\n  /** A button useful for purchase experiences that include other payment buttons that start with “Check out”. */\n  Checkout = 5,\n  /** A button used by approved nonprofit organization that lets people make donations. */\n  Donate = 4,\n  /** A button useful for placing orders for such as like meals or flowers. */\n  Order = 11,\n  /** A button useful for purchasing a subscription such as a gym membership or meal-kit delivery service. */\n  Subscribe = 7,\n  /** iOS only. A button useful for prompting the user to set up a card. */\n  SetUp = 2,\n  /** iOS only. A button useful for paying bills or invoices. */\n  InStore = 3,\n  /** iOS only. A button useful for adding money to a card, account, or payment system.*/\n  Reload = 8,\n  /** iOS only. A button useful for adding money to a card, account, or payment system. */\n  AddMoney = 9,\n  /** iOS only. A button useful for adding money to a card, account, or payment system. */\n  TopUp = 10,\n  /** iOS only. A button useful for renting items such as cars or scooters. */\n  Rent = 12,\n  /** iOS only. A button useful supporting people give money to projects, causes, organizations, and other entities.*/\n  Support = 13,\n  /** iOS only. A button useful to help people contribute money to projects, causes, organizations, and other entities. */\n  Contribute = 14,\n  /** iOS only. A button useful useful for letting people tip for goods or services. */\n  Tip = 15,\n  /** iOS only. A button useful for general purchases. */\n  Continue = 16,\n  /** Android only. A button useful for general payments. */\n  Pay = 1000,\n  /** Android only. A plain white button with the Google Pay logo. Use when you show Google Pay as a payment option in your payment flows. */\n  GooglePayMark = 1001,\n}\n\n/** iOS only. */\nexport enum ButtonStyle {\n  /** A white button with black lettering. */\n  White = 0,\n  /** A white button with black lettering and a black outline. */\n  WhiteOutline = 1,\n  /** A black button with white lettering. */\n  Black = 2,\n  /** Default. A button that automatically changes its appearance when the user switches between Light Mode and Dark Mode. */\n  Automatic = 3,\n}\n\n/** iOS only. */\nexport type CartSummaryItem =\n  | DeferredCartSummaryItem\n  | ImmediateCartSummaryItem\n  | RecurringCartSummaryItem;\n\n/** iOS only. */\nexport enum PaymentType {\n  Deferred = 'Deferred',\n  Immediate = 'Immediate',\n  Recurring = 'Recurring',\n}\n\n/** iOS only. Use this type for a payment that occurs in the future, such as a pre-order. Only available on iOS 15 and up, otherwise falls back to ImmediateCartSummaryItem. */\nexport type DeferredCartSummaryItem = {\n  paymentType: PaymentType.Deferred;\n  /** The unix timestamp of the date, in the future, of the payment. Measured in seconds. */\n  deferredDate: number;\n  label: string;\n  amount: string;\n};\n\n/** iOS only. Use this type for payments that will occur immediately. */\nexport type ImmediateCartSummaryItem = {\n  paymentType: PaymentType.Immediate;\n  /** When creating items for estimates or charges whose final value is not yet known, set this to true. */\n  isPending?: boolean;\n  label: string;\n  amount: string;\n};\n\n/** iOS only. Use this type for payments that occur more than once, such as a subscription. Only available on iOS 15 and up, otherwise falls back to ImmediateCartSummaryItem.*/\nexport type RecurringCartSummaryItem = {\n  paymentType: PaymentType.Recurring;\n  /** The amount of time – in calendar units such as Day, Month, or Year – that represents a fraction of the total payment interval. For example, if you set the intervalUnit to 'Month' and intervalCount to 3, then the payment interval is three months.*/\n  intervalUnit: IntervalUnit;\n  /** The number of interval units that make up the total payment interval. For example, if you set the intervalUnit to 'Month' and intervalCount to 3, then the payment interval is three months.*/\n  intervalCount: number;\n  /** The unix timestamp of the start date. Measured in seconds. */\n  startDate?: number;\n  /** The unix timestamp of the end date. Measured in seconds. */\n  endDate?: number;\n  label: string;\n  amount: string;\n};\n\n/** iOS only. */\nexport enum IntervalUnit {\n  Minute = 'minute',\n  Hour = 'hour',\n  Day = 'day',\n  Month = 'month',\n  Year = 'year',\n}\n\n/** iOS only. */\nexport type ShippingMethod = {\n  /** A short, localized description. */\n  label: string;\n  /** The cost associated with this shipping option. */\n  amount: string;\n  /** When creating items for estimates or charges whose final value is not yet known, set this to true. */\n  isPending?: boolean;\n  /** A unique identifier for the shipping method. */\n  identifier: string;\n  /** A user-readable description of the shipping method. For example “Ships in 24 hours.” Don't repeat the content of the 'label' property. */\n  detail?: string;\n  /** The unix timestamp of the start date of the expected range of delivery or shipping dates for a package, or the time range when an item is available for pickup. Measured in seconds. */\n  startDate?: number;\n  /** The unix timestamp of the end date of the expected range of delivery or shipping dates for a package, or the time range when an item is available for pickup. Measured in seconds. */\n  endDate?: number;\n};\n\n/** iOS only. */\nexport type ShippingContact = ApplePayShippingContact;\n\n/** Android only. */\nexport type IsGooglePaySupportedParams = IsSupportedParams;\n\nexport type PaymentMethodResult =\n  | {\n      paymentMethod: PaymentMethod;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n\nexport type TokenResult =\n  | {\n      token: Token;\n      error?: undefined;\n    }\n  | {\n      token?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n\nexport type ConfirmPaymentResult =\n  | {\n      paymentIntent: PaymentIntent;\n      error?: StripeError<PlatformPayError>;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n\nexport type ConfirmSetupIntentResult =\n  | {\n      setupIntent: SetupIntent;\n      error?: StripeError<PlatformPayError>;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<PlatformPayError>;\n    };\n"],"mappings":"4VAsBYA,uBAAsB,iEAAtBA,sBAAsB,EAAtBA,sBAAsB,oDAAtBA,sBAAsB,gEAAtBA,sBAAsB,0CAAtBA,sBAAsB,6CAAtBA,sBAAsB,kCAAtBA,sBAAsB,SAOtBC,aAAY,6CAAZA,YAAY,EAAZA,YAAY,gCAAZA,YAAY,gBAAZA,YAAY,8BAAZA,YAAY,gCAAZA,YAAY,qCAAZA,YAAY,wBAAZA,YAAY,SAQZC,qBAAoB,6DAApBA,oBAAoB,EAApBA,oBAAoB,oBAApBA,oBAAoB,gBAApBA,oBAAoB,kDAApBA,oBAAoB,kBAApBA,oBAAoB,4BAApBA,oBAAoB,sBAApBA,oBAAoB,8BAApBA,oBAAoB,iCAApBA,oBAAoB,gCAApBA,oBAAoB,SA0CpBC,mBAAkB,yDAAlBA,kBAAkB,EAAlBA,kBAAkB,0BAAlBA,kBAAkB,sCAAlBA,kBAAkB,qCAAlBA,kBAAkB,8BAAlBA,kBAAkB,SAsElBC,2BAA0B,yEAA1BA,0BAA0B,EAA1BA,0BAA0B,8BAA1BA,0BAA0B,oCAA1BA,0BAA0B,qCAA1BA,0BAA0B,sCAA1BA,0BAA0B,SAU1BC,qBAAoB,6DAApBA,oBAAoB,EAApBA,oBAAoB,wBAApBA,oBAAoB,wBAApBA,oBAAoB,8BAApBA,oBAAoB,qCAApBA,oBAAoB,gCAApBA,oBAAoB,SAsDpBC,qBAAoB,6DAApBA,oBAAoB,EAApBA,oBAAoB,gBAApBA,oBAAoB,iBAApBA,oBAAoB,gCAApBA,oBAAoB,SAqBpBC,WAAU,yCAAVA,UAAU,EAAVA,UAAU,CAAVA,UAAU,yBAAVA,UAAU,CAAVA,UAAU,iBAAVA,UAAU,CAAVA,UAAU,mBAAVA,UAAU,CAAVA,UAAU,2BAAVA,UAAU,CAAVA,UAAU,uBAAVA,UAAU,CAAVA,UAAU,sBAAVA,UAAU,CAAVA,UAAU,6BAAVA,UAAU,CAAVA,UAAU,qBAAVA,UAAU,CAAVA,UAAU,yBAAVA,UAAU,CAAVA,UAAU,uBAAVA,UAAU,CAAVA,UAAU,2BAAVA,UAAU,CAAVA,UAAU,sBAAVA,UAAU,CAAVA,UAAU,oBAAVA,UAAU,CAAVA,UAAU,0BAAVA,UAAU,CAAVA,UAAU,gCAAVA,UAAU,CAAVA,UAAU,kBAAVA,UAAU,CAAVA,UAAU,4BAAVA,UAAU,CAAVA,UAAU,oBAAVA,UAAU,CAAVA,UAAU,2CAAVA,UAAU,sBAAVA,UAAU,SA0CVC,YAAW,2CAAXA,WAAW,EAAXA,WAAW,CAAXA,WAAW,qBAAXA,WAAW,CAAXA,WAAW,mCAAXA,WAAW,CAAXA,WAAW,qBAAXA,WAAW,CAAXA,WAAW,gCAAXA,WAAW,uBAAXA,WAAW,SAkBXC,YAAW,2CAAXA,WAAW,EAAXA,WAAW,wBAAXA,WAAW,0BAAXA,WAAW,6BAAXA,WAAW,uBAAXA,WAAW,SAwCXC,aAAY,6CAAZA,YAAY,EAAZA,YAAY,oBAAZA,YAAY,gBAAZA,YAAY,cAAZA,YAAY,kBAAZA,YAAY,mBAAZA,YAAY,wBAAZA,YAAY"}

package/lib/module/types/components/ApplePayButtonComponent.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["ApplePayButtonComponent.ts"],"sourcesContent":["import type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';\nimport type { ShippingMethod, ShippingContact } from '../PlatformPay';\nexport interface NativeProps {\n  style?: StyleProp<ViewStyle>;\n  disabled?: boolean;\n  type?: number;\n  buttonStyle?: number;\n  borderRadius?: number;\n  onPressAction?(): void;\n  onShippingMethodSelectedAction?: (\n    value: NativeSyntheticEvent<{\n      shippingMethod: ShippingMethod;\n    }>\n  ) => void;\n  onShippingContactSelectedAction?: (\n    value: NativeSyntheticEvent<{\n      shippingContact: ShippingContact;\n    }>\n  ) => void;\n  onCouponCodeEnteredAction?: (\n    value: NativeSyntheticEvent<{\n      couponCode: string;\n    }>\n  ) => void;\n}\n\nexport type Type =\n  | 'plain'\n  | 'buy'\n  | 'setUp'\n  | 'inStore'\n  | 'donate'\n  | 'checkout'\n  | 'book'\n  | 'subscribe'\n  | 'reload'\n  | 'addMoney'\n  | 'topUp'\n  | 'order'\n  | 'rent'\n  | 'support'\n  | 'contribute'\n  | 'tip'\n  | 'continue';\n\nexport type Style = 'white' | 'whiteOutline' | 'black' | 'automatic';\n"],"mappings":""}
+{"version":3,"names":[],"sources":["ApplePayButtonComponent.ts"],"sourcesContent":["import type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';\nimport type { ShippingMethod, ShippingContact } from '../PlatformPay';\nexport interface NativeProps {\n  style?: StyleProp<ViewStyle>;\n  disabled?: boolean;\n  type?: number;\n  buttonStyle?: number;\n  borderRadius?: number;\n  onPressAction?(): void;\n  onShippingMethodSelectedAction?: (\n    value: NativeSyntheticEvent<{\n      shippingMethod: ShippingMethod;\n    }>\n  ) => void;\n  onShippingContactSelectedAction?: (\n    value: NativeSyntheticEvent<{\n      shippingContact: ShippingContact;\n    }>\n  ) => void;\n  onCouponCodeEnteredAction?: (\n    value: NativeSyntheticEvent<{\n      couponCode: string;\n    }>\n  ) => void;\n  onOrderTrackingAction?: () => void;\n}\n\nexport type Type =\n  | 'plain'\n  | 'buy'\n  | 'setUp'\n  | 'inStore'\n  | 'donate'\n  | 'checkout'\n  | 'book'\n  | 'subscribe'\n  | 'reload'\n  | 'addMoney'\n  | 'topUp'\n  | 'order'\n  | 'rent'\n  | 'support'\n  | 'contribute'\n  | 'tip'\n  | 'continue';\n\nexport type Style = 'white' | 'whiteOutline' | 'black' | 'automatic';\n"],"mappings":""}

package/lib/typescript/src/NativeStripeSdk.d.ts

@@ -15,7 +15,8 @@ declare type NativeStripeSdkType = {
     retrievePaymentIntent(clientSecret: string): Promise<RetrievePaymentIntentResult>;
     retrieveSetupIntent(clientSecret: string): Promise<RetrieveSetupIntentResult>;
     initPaymentSheet(params: PaymentSheet.SetupParams): Promise<InitPaymentSheetResult>;
-    presentPaymentSheet(): Promise<PresentPaymentSheetResult>;
+    initPaymentSheetWithOrderTracking(params: PaymentSheet.SetupParams, callback?: () => void): Promise<InitPaymentSheetResult>;
+    presentPaymentSheet(options: PaymentSheet.PresentOptions): Promise<PresentPaymentSheetResult>;
     confirmPaymentSheetPayment(): Promise<ConfirmPaymentSheetPaymentResult>;
     createTokenForCVCUpdate(cvc: string): Promise<CreateTokenForCVCUpdateResult>;
     handleURLCallback(url: string): Promise<boolean>;
@@ -47,6 +48,7 @@ declare type NativeStripeSdkType = {
     dismissPlatformPay(): Promise<boolean>;
     updatePlatformPaySheet(summaryItems: Array<ApplePay.CartSummaryItem>, shippingMethods: Array<ApplePay.ShippingMethod>, errors: Array<PlatformPay.ApplePaySheetError>): Promise<void>;
     confirmPlatformPay(clientSecret: string, params: PlatformPay.ConfirmParams, isPaymentIntent: boolean): Promise<PlatformPay.ConfirmPaymentResult | PlatformPay.ConfirmSetupIntentResult>;
+    configureOrderTracking(orderTypeIdentifier: string, orderIdentifier: string, webServiceUrl: string, authenticationToken: string): Promise<void>;
 };
 declare const _default: NativeStripeSdkType;
 export default _default;

package/lib/typescript/src/components/PlatformPayButton.d.ts

@@ -41,6 +41,11 @@ export interface Props extends AccessibilityProps {
     onCouponCodeEntered?: (event: {
         couponCode: string;
     }) => void;
+    /** Callback function for setting the order details (retrieved from your server) to give users the
+     * ability to track and manage their purchases in Wallet. Stripe calls your implementation after the
+     * payment is complete, but before iOS dismisses the Apple Pay sheet. You must call the `completion`
+     * function, or else the Apple Pay sheet will hang.*/
+    setOrderTracking?: (completion: (orderIdentifier: string, orderTypeIdentifier: string, authenticationToken: string, webServiceUrl: string) => void) => void;
     testID?: string;
     style?: StyleProp<ViewStyle>;
 }
@@ -62,4 +67,4 @@ export interface Props extends AccessibilityProps {
  * @returns JSX.Element
  * @category ReactComponents
  */
-export declare function PlatformPayButton({ type, appearance, onPress, disabled, borderRadius, onShippingMethodSelected, onShippingContactSelected, onCouponCodeEntered, ...props }: Props): JSX.Element;
+export declare function PlatformPayButton({ type, appearance, onPress, disabled, borderRadius, onShippingMethodSelected, onShippingContactSelected, onCouponCodeEntered, setOrderTracking, style, ...props }: Props): JSX.Element;

package/lib/typescript/src/functions.d.ts

@@ -40,7 +40,7 @@ export declare const handleURLCallback: (url: string) => Promise<boolean>;
 export declare const verifyMicrodepositsForPayment: (clientSecret: string, params: VerifyMicrodepositsParams) => Promise<VerifyMicrodepositsForPaymentResult>;
 export declare const verifyMicrodepositsForSetup: (clientSecret: string, params: VerifyMicrodepositsParams) => Promise<VerifyMicrodepositsForSetupResult>;
 export declare const initPaymentSheet: (params: PaymentSheet.SetupParams) => Promise<InitPaymentSheetResult>;
-export declare const presentPaymentSheet: () => Promise<PresentPaymentSheetResult>;
+export declare const presentPaymentSheet: (options?: PaymentSheet.PresentOptions) => Promise<PresentPaymentSheetResult>;
 export declare const confirmPaymentSheetPayment: () => Promise<ConfirmPaymentSheetPaymentResult>;
 /**
  * You must call this method when the user logs out from your app. This will ensure that

package/lib/typescript/src/hooks/usePaymentSheet.d.ts

@@ -5,7 +5,7 @@ import type { PaymentSheet } from '../types';
 export declare function usePaymentSheet(): {
     loading: boolean;
     initPaymentSheet: (params: PaymentSheet.SetupParams) => Promise<import("../types").InitPaymentSheetResult>;
-    presentPaymentSheet: () => Promise<import("../types").PresentPaymentSheetResult>;
+    presentPaymentSheet: (options?: PaymentSheet.PresentOptions | undefined) => Promise<import("../types").PresentPaymentSheetResult>;
     confirmPaymentSheetPayment: () => Promise<import("../types").ConfirmPaymentSheetPaymentResult>;
     /**
      * You must call this method when the user logs out from your app. This will ensure that

package/lib/typescript/src/hooks/useStripe.d.ts

@@ -23,7 +23,7 @@ export declare function useStripe(): {
     }>;
     handleURLCallback: (url: string) => Promise<boolean>;
     confirmPaymentSheetPayment: () => Promise<ConfirmPaymentSheetPaymentResult>;
-    presentPaymentSheet: () => Promise<PresentPaymentSheetResult>;
+    presentPaymentSheet: (options?: PaymentSheet.PresentOptions | undefined) => Promise<PresentPaymentSheetResult>;
     initPaymentSheet: (params: PaymentSheet.SetupParams) => Promise<InitPaymentSheetResult>;
     createToken: (params: Token.CreateParams) => Promise<CreateTokenResult>;
     isGooglePaySupported: (params?: GooglePay.IsSupportedParams | undefined) => Promise<boolean>;

package/lib/typescript/src/types/Errors.d.ts

@@ -32,7 +32,8 @@ export declare enum ApplePayError {
 }
 export declare enum PaymentSheetError {
     Failed = "Failed",
-    Canceled = "Canceled"
+    Canceled = "Canceled",
+    Timeout = "Timeout"
 }
 export declare type ErrorType = 'api_connection_error' | 'api_error' | 'authentication_error' | 'card_error' | 'idempotency_error' | 'invalid_request_error' | 'rate_limit_error';
 export interface StripeError<T> {

package/lib/typescript/src/types/PaymentSheet.d.ts

@@ -1,5 +1,6 @@
 import type { BillingDetails, AddressDetails } from './Common';
 import type { CartSummaryItem } from './ApplePay';
+import type { ButtonType, RecurringPaymentRequest, AutomaticReloadPaymentRequest, MultiMerchantRequest } from './PlatformPay';
 export declare type SetupParams = ClientSecretParams & {
     /** Your customer-facing business name. On Android, this is required and cannot be an empty string. */
     merchantDisplayName: string;
@@ -52,7 +53,16 @@ export declare type ApplePayParams = {
     /**
      * An array of CartSummaryItem item objects that summarize the amount of the payment. If you're using a SetupIntent
      * for a recurring payment, you should set this to display the amount you intend to charge. */
-    paymentSummaryItems?: CartSummaryItem[];
+    cartItems?: CartSummaryItem[];
+    /** Sets the text displayed by the call to action button in the Apple Pay sheet. */
+    buttonType?: ButtonType;
+    /** A typical request is for a one-time payment. To support different types of payment requests, include a PaymentRequestType. Only supported on iOS 16 and up. */
+    request?: RecurringPaymentRequest | AutomaticReloadPaymentRequest | MultiMerchantRequest;
+    /** Callback function for setting the order details (retrieved from your server) to give users the
+     * ability to track and manage their purchases in Wallet. Stripe calls your implementation after the
+     * payment is complete, but before iOS dismisses the Apple Pay sheet. You must call the `completion`
+     * function, or else the Apple Pay sheet will hang. */
+    setOrderTracking?: (completion: (orderIdentifier: string, orderTypeIdentifier: string, authenticationToken: string, webServiceUrl: string) => void) => void;
 };
 export declare type GooglePayParams = {
     /** The two-letter ISO 3166 code of the country of your business, e.g. "US"  */
@@ -218,4 +228,10 @@ export interface PaymentOption {
     label: string;
     image: string;
 }
+export declare type PresentOptions = {
+    /** The number of milliseconds (after presenting) before the Payment Sheet closes automatically, at which point
+     *`presentPaymentSheet` will resolve with an `error.code` of `PaymentSheetError.Timeout`. The default is no timeout.
+     */
+    timeout?: number;
+};
 export {};

package/lib/typescript/src/types/PlatformPay.d.ts

@@ -58,6 +58,69 @@ export declare type ApplePayBaseParams = {
     /** A list of two-letter ISO 3166 country codes for limiting payment to cards from specific countries or regions. */
     supportedCountries?: Array<string>;
 };
+export declare type ApplePayConfirmParams = {
+    /** A typical request is for a one-time payment. To support different types of payment requests, include a PaymentRequestType. Only supported on iOS 16 and up. */
+    request?: RecurringPaymentRequest | AutomaticReloadPaymentRequest | MultiMerchantRequest;
+};
+export declare enum PaymentRequestType {
+    Recurring = "Recurring",
+    AutomaticReload = "AutomaticReload",
+    MultiMerchant = "MultiMerchant"
+}
+/** Use this for a recurring payment, typically a subscription. */
+export declare type RecurringPaymentRequest = {
+    type: PaymentRequestType.Recurring;
+    /** A description that you provide of the recurring payment and that Apple Pay displays to the user in the sheet. */
+    description: string;
+    /** A URL to a web page where the user can update or delete the payment method for the recurring payment. */
+    managementUrl: string;
+    /** The regular billing cycle for the payment, including start and end dates, an interval, and an interval count. */
+    billing: RecurringCartSummaryItem;
+    /** Same as the billing property, but use this if the purchase has a trial period. */
+    trialBilling?: RecurringCartSummaryItem;
+    /** A localized billing agreement that the sheet displays to the user before the user authorizes the payment. */
+    billingAgreement?: string;
+    /** A URL you provide to receive life-cycle notifications from the Apple Pay servers about the Apple Pay merchant token for the recurring payment.
+     * For more information about handling merchant token life-cycle notifications, see Receiving and handling merchant token notifications.
+     */
+    tokenNotificationURL?: string;
+};
+/** Use this for an automatic reload or refill payment, such as a store card top-up. */
+export declare type AutomaticReloadPaymentRequest = {
+    type: PaymentRequestType.AutomaticReload;
+    /** A description that you provide of the recurring payment and that Apple Pay displays to the user in the sheet. */
+    description: string;
+    /** A URL to a web page where the user can update or delete the payment method for the recurring payment. */
+    managementUrl: string;
+    /** A short, localized description of the item. */
+    label: string;
+    /** This is the amount that is automatically applied to the account when the account balance drops below the threshold amount. */
+    reloadAmount: string;
+    /** The balance an account reaches before you apply the automatic reload amount. */
+    thresholdAmount: string;
+    /** A localized billing agreement that the sheet displays to the user before the user authorizes the payment. */
+    billingAgreement?: string;
+    /** A URL you provide to receive life-cycle notifications from the Apple Pay servers about the Apple Pay merchant token for the recurring payment.
+     * For more information about handling merchant token life-cycle notifications, see Receiving and handling merchant token notifications.
+     */
+    tokenNotificationURL?: string;
+};
+/** Use this to indicate payments for multiple merchants. */
+export declare type MultiMerchantRequest = {
+    type: PaymentRequestType.MultiMerchant;
+    merchants: Array<{
+        /** The Apple Pay merchant identifier. */
+        merchantIdentifier: string;
+        /** An external identifier for the merchant. */
+        externalIdentifier: string;
+        /** The merchant’s display name that the Apple Pay server associates with the payment token. */
+        merchantName: string;
+        /** The merchant’s top-level domain that the Apple Pay server associates with the payment token. */
+        merchantDomain?: string;
+        /** The amount to authorize for the payment token. */
+        amount: string;
+    }>;
+};
 export declare type ApplePayPaymentMethodParams = {
     /** Set this value to true to display the coupon code field, or pass the 'couponCode' field to autofill with a coupon code. Defaults to false. If true, you must implement the PlatformPayButton component's `onCouponCodeEntered` callback and call `updatePlatformPaySheet` from there. */
     supportsCouponCode?: boolean;
@@ -140,7 +203,7 @@ export declare type ConfirmParams = {
     /** Defines Google Pay behavior. Android only. */
     googlePay?: GooglePayBaseParams;
     /** Defines Apple Pay behavior. iOS only. */
-    applePay?: ApplePayBaseParams;
+    applePay?: ApplePayBaseParams & ApplePayConfirmParams;
 };
 export declare enum ButtonType {
     /** A button with the Apple Pay or Google Pay logo only, useful when an additional call to action isn't needed. */

package/lib/typescript/src/types/components/ApplePayButtonComponent.d.ts

@@ -16,6 +16,7 @@ export interface NativeProps {
     onCouponCodeEnteredAction?: (value: NativeSyntheticEvent<{
         couponCode: string;
     }>) => void;
+    onOrderTrackingAction?: () => void;
 }
 export declare type Type = 'plain' | 'buy' | 'setUp' | 'inStore' | 'donate' | 'checkout' | 'book' | 'subscribe' | 'reload' | 'addMoney' | 'topUp' | 'order' | 'rent' | 'support' | 'contribute' | 'tip' | 'continue';
 export declare type Style = 'white' | 'whiteOutline' | 'black' | 'automatic';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-react-native",
-  "version": "0.23.2",
+  "version": "0.24.0",
   "author": "Stripe",
   "description": "Stripe SDK for React Native",
   "main": "lib/commonjs/index",
@@ -57,7 +57,7 @@
     "metro-react-native-babel-preset": "^0.70.3",
     "prettier": "^2.0.5",
     "react": "18.0.0",
-    "react-native": "0.69.2",
+    "react-native": "0.69.7",
     "ts-node": "^9.1.1",
     "typedoc": "^0.22.12",
     "typescript": "~4.4.4"

package/src/NativeStripeSdk.tsx

@@ -69,7 +69,13 @@ type NativeStripeSdkType = {
   initPaymentSheet(
     params: PaymentSheet.SetupParams
   ): Promise<InitPaymentSheetResult>;
-  presentPaymentSheet(): Promise<PresentPaymentSheetResult>;
+  initPaymentSheetWithOrderTracking(
+    params: PaymentSheet.SetupParams,
+    callback?: () => void
+  ): Promise<InitPaymentSheetResult>;
+  presentPaymentSheet(
+    options: PaymentSheet.PresentOptions
+  ): Promise<PresentPaymentSheetResult>;
   confirmPaymentSheetPayment(): Promise<ConfirmPaymentSheetPaymentResult>;
   createTokenForCVCUpdate(cvc: string): Promise<CreateTokenForCVCUpdateResult>;
   handleURLCallback(url: string): Promise<boolean>;
@@ -127,6 +133,12 @@ type NativeStripeSdkType = {
   ): Promise<
     PlatformPay.ConfirmPaymentResult | PlatformPay.ConfirmSetupIntentResult
   >;
+  configureOrderTracking(
+    orderTypeIdentifier: string,
+    orderIdentifier: string,
+    webServiceUrl: string,
+    authenticationToken: string
+  ): Promise<void>;
 };
 
 const { StripeSdk } = NativeModules;

package/src/components/PlatformPayButton.tsx

@@ -8,6 +8,7 @@ import {
   Platform,
   NativeSyntheticEvent,
 } from 'react-native';
+import NativeStripeSdk from '../NativeStripeSdk';
 import {
   ButtonType,
   ButtonStyle,
@@ -56,6 +57,18 @@ export interface Props extends AccessibilityProps {
    * Apple Pay sheet will hang and the payment flow will automatically cancel.
    */
   onCouponCodeEntered?: (event: { couponCode: string }) => void;
+  /** Callback function for setting the order details (retrieved from your server) to give users the
+   * ability to track and manage their purchases in Wallet. Stripe calls your implementation after the
+   * payment is complete, but before iOS dismisses the Apple Pay sheet. You must call the `completion`
+   * function, or else the Apple Pay sheet will hang.*/
+  setOrderTracking?: (
+    completion: (
+      orderIdentifier: string,
+      orderTypeIdentifier: string,
+      authenticationToken: string,
+      webServiceUrl: string
+    ) => void
+  ) => void;
   testID?: string;
   style?: StyleProp<ViewStyle>;
 }
@@ -87,6 +100,8 @@ export function PlatformPayButton({
   onShippingMethodSelected,
   onShippingContactSelected,
   onCouponCodeEntered,
+  setOrderTracking,
+  style,
   ...props
 }: Props) {
   const shippingMethodCallback = onShippingMethodSelected
@@ -119,12 +134,18 @@ export function PlatformPayButton({
       }
     : undefined;
 
+  const orderTrackingCallback = setOrderTracking
+    ? () => {
+        setOrderTracking(NativeStripeSdk.configureOrderTracking);
+      }
+    : undefined;
+
   return (
     <TouchableOpacity
       disabled={disabled}
       activeOpacity={disabled ? 0.3 : 1}
       onPress={onPress}
-      style={disabled ? styles.disabled : styles.notDisabled}
+      style={[disabled ? styles.disabled : styles.notDisabled, style]}
     >
       {Platform.OS === 'ios' ? (
         <ApplePayButtonNative
@@ -135,10 +156,16 @@ export function PlatformPayButton({
           onShippingMethodSelectedAction={shippingMethodCallback}
           onShippingContactSelectedAction={shippingContactCallback}
           onCouponCodeEnteredAction={couponCodeCallback}
+          onOrderTrackingAction={orderTrackingCallback}
+          style={styles.nativeButtonStyle}
           {...props}
         />
       ) : (
-        <GooglePayButtonNative type={type} {...props} />
+        <GooglePayButtonNative
+          type={type}
+          style={styles.nativeButtonStyle}
+          {...props}
+        />
       )}
     </TouchableOpacity>
   );
@@ -147,9 +174,10 @@ export function PlatformPayButton({
 const styles = StyleSheet.create({
   disabled: {
     flex: 0,
-    opacity: 0.3,
+    opacity: 0.4,
   },
   notDisabled: {
     flex: 0,
   },
+  nativeButtonStyle: { flex: 1 },
 });

package/src/functions.ts

@@ -405,17 +405,28 @@ export const verifyMicrodepositsForSetup = async (
 export const initPaymentSheet = async (
   params: PaymentSheet.SetupParams
 ): Promise<InitPaymentSheetResult> => {
+  let result;
+
+  const setOrderTracking = params?.applePay?.setOrderTracking;
   try {
-    const { paymentOption, error } = await NativeStripeSdk.initPaymentSheet(
-      params
-    );
-    if (error) {
+    if (setOrderTracking && Platform.OS === 'ios') {
+      result = await NativeStripeSdk.initPaymentSheetWithOrderTracking(
+        params,
+        () => {
+          setOrderTracking(NativeStripeSdk.configureOrderTracking);
+        }
+      );
+    } else {
+      result = await NativeStripeSdk.initPaymentSheet(params);
+    }
+
+    if (result.error) {
       return {
-        error,
+        error: result.error,
       };
     }
     return {
-      paymentOption,
+      paymentOption: result.paymentOption,
     };
   } catch (error: any) {
     return {
@@ -424,25 +435,27 @@ export const initPaymentSheet = async (
   }
 };
 
-export const presentPaymentSheet =
-  async (): Promise<PresentPaymentSheetResult> => {
-    try {
-      const { paymentOption, error } =
-        await NativeStripeSdk.presentPaymentSheet();
-      if (error) {
-        return {
-          error,
-        };
-      }
-      return {
-        paymentOption: paymentOption!,
-      };
-    } catch (error: any) {
+export const presentPaymentSheet = async (
+  options: PaymentSheet.PresentOptions = {}
+): Promise<PresentPaymentSheetResult> => {
+  try {
+    const { paymentOption, error } = await NativeStripeSdk.presentPaymentSheet(
+      options
+    );
+    if (error) {
       return {
         error,
       };
     }
-  };
+    return {
+      paymentOption: paymentOption!,
+    };
+  } catch (error: any) {
+    return {
+      error,
+    };
+  }
+};
 
 export const confirmPaymentSheetPayment =
   async (): Promise<ConfirmPaymentSheetPaymentResult> => {

package/src/hooks/usePaymentSheet.tsx

@@ -21,9 +21,9 @@ export function usePaymentSheet() {
     return result;
   };
 
-  const presentPaymentSheet = async () => {
+  const presentPaymentSheet = async (options?: PaymentSheet.PresentOptions) => {
     setLoading(true);
-    const result = await presentPaymentSheetNative();
+    const result = await presentPaymentSheetNative(options);
     setLoading(false);
     return result;
   };

package/src/hooks/useStripe.tsx

@@ -203,10 +203,14 @@ export function useStripe() {
     []
   );
 
-  const _presentPaymentSheet =
-    useCallback(async (): Promise<PresentPaymentSheetResult> => {
-      return presentPaymentSheet();
-    }, []);
+  const _presentPaymentSheet = useCallback(
+    async (
+      options?: PaymentSheet.PresentOptions
+    ): Promise<PresentPaymentSheetResult> => {
+      return presentPaymentSheet(options);
+    },
+    []
+  );
 
   const _confirmPaymentSheetPayment =
     useCallback(async (): Promise<ConfirmPaymentSheetPaymentResult> => {

package/src/types/Errors.ts

@@ -41,6 +41,7 @@ export enum ApplePayError {
 export enum PaymentSheetError {
   Failed = 'Failed',
   Canceled = 'Canceled',
+  Timeout = 'Timeout',
 }
 
 export type ErrorType =

package/src/types/PaymentSheet.ts

@@ -1,5 +1,11 @@
 import type { BillingDetails, AddressDetails } from './Common';
 import type { CartSummaryItem } from './ApplePay';
+import type {
+  ButtonType,
+  RecurringPaymentRequest,
+  AutomaticReloadPaymentRequest,
+  MultiMerchantRequest,
+} from './PlatformPay';
 
 export type SetupParams = ClientSecretParams & {
   /** Your customer-facing business name. On Android, this is required and cannot be an empty string. */
@@ -57,9 +63,26 @@ export type ApplePayParams = {
   /**
    * An array of CartSummaryItem item objects that summarize the amount of the payment. If you're using a SetupIntent
    * for a recurring payment, you should set this to display the amount you intend to charge. */
-  paymentSummaryItems?: CartSummaryItem[];
-  // TODO: Uncomment when https://github.com/stripe/stripe-react-native/pull/1164 lands
-  // buttonType: ButtonType
+  cartItems?: CartSummaryItem[];
+  /** Sets the text displayed by the call to action button in the Apple Pay sheet. */
+  buttonType?: ButtonType;
+  /** A typical request is for a one-time payment. To support different types of payment requests, include a PaymentRequestType. Only supported on iOS 16 and up. */
+  request?:
+    | RecurringPaymentRequest
+    | AutomaticReloadPaymentRequest
+    | MultiMerchantRequest;
+  /** Callback function for setting the order details (retrieved from your server) to give users the
+   * ability to track and manage their purchases in Wallet. Stripe calls your implementation after the
+   * payment is complete, but before iOS dismisses the Apple Pay sheet. You must call the `completion`
+   * function, or else the Apple Pay sheet will hang. */
+  setOrderTracking?: (
+    completion: (
+      orderIdentifier: string,
+      orderTypeIdentifier: string,
+      authenticationToken: string,
+      webServiceUrl: string
+    ) => void
+  ) => void;
 };
 
 export type GooglePayParams = {
@@ -232,3 +255,10 @@ export interface PaymentOption {
   label: string;
   image: string;
 }
+
+export type PresentOptions = {
+  /** The number of milliseconds (after presenting) before the Payment Sheet closes automatically, at which point
+   *`presentPaymentSheet` will resolve with an `error.code` of `PaymentSheetError.Timeout`. The default is no timeout.
+   */
+  timeout?: number;
+};