@bigcommerce/checkout-sdk 1.281.2 → 1.282.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +7 -0
- package/dist/checkout-button.js +1 -1
- package/dist/checkout-button.js.map +1 -1
- package/dist/checkout-button.umd.js +1 -1
- package/dist/checkout-button.umd.js.map +1 -1
- package/dist/checkout-sdk.d.ts +112 -0
- package/dist/checkout-sdk.js +1 -1
- package/dist/checkout-sdk.js.map +1 -1
- package/dist/checkout-sdk.umd.js +1 -1
- package/dist/checkout-sdk.umd.js.map +1 -1
- package/docs/README.md +12 -0
- package/docs/interfaces/BaseCustomerInitializeOptions.md +10 -0
- package/docs/interfaces/ShippingInitializeOptions.md +10 -0
- package/docs/interfaces/StripeCustomerEvent.md +74 -0
- package/docs/interfaces/StripeEvent.md +37 -0
- package/docs/interfaces/StripeShippingEvent.md +74 -0
- package/docs/interfaces/StripeUPECustomerInitializeOptions.md +92 -0
- package/docs/interfaces/StripeUPEShippingInitializeOptions.md +87 -0
- package/package.json +1 -1
package/docs/README.md
CHANGED
|
@@ -330,11 +330,16 @@
|
|
|
330
330
|
- [StoreCurrency](interfaces/StoreCurrency.md)
|
|
331
331
|
- [StoreLinks](interfaces/StoreLinks.md)
|
|
332
332
|
- [StoreProfile](interfaces/StoreProfile.md)
|
|
333
|
+
- [StripeCustomerEvent](interfaces/StripeCustomerEvent.md)
|
|
333
334
|
- [StripeElementCSSProperties](interfaces/StripeElementCSSProperties.md)
|
|
334
335
|
- [StripeElementClasses](interfaces/StripeElementClasses.md)
|
|
335
336
|
- [StripeElementStyle](interfaces/StripeElementStyle.md)
|
|
336
337
|
- [StripeElementStyleVariant](interfaces/StripeElementStyleVariant.md)
|
|
338
|
+
- [StripeEvent](interfaces/StripeEvent.md)
|
|
339
|
+
- [StripeShippingEvent](interfaces/StripeShippingEvent.md)
|
|
340
|
+
- [StripeUPECustomerInitializeOptions](interfaces/StripeUPECustomerInitializeOptions.md)
|
|
337
341
|
- [StripeUPEPaymentInitializeOptions](interfaces/StripeUPEPaymentInitializeOptions.md)
|
|
342
|
+
- [StripeUPEShippingInitializeOptions](interfaces/StripeUPEShippingInitializeOptions.md)
|
|
338
343
|
- [StripeV3PaymentInitializeOptions](interfaces/StripeV3PaymentInitializeOptions.md)
|
|
339
344
|
- [StyleOptions](interfaces/StyleOptions.md)
|
|
340
345
|
- [StyleOptions_2](interfaces/StyleOptions_2.md)
|
|
@@ -411,6 +416,7 @@
|
|
|
411
416
|
- [PaypalCommerceFormFieldStyles](README.md#paypalcommerceformfieldstyles)
|
|
412
417
|
- [PaypalCommerceInitializeOptions](README.md#paypalcommerceinitializeoptions)
|
|
413
418
|
- [StripeElementOptions](README.md#stripeelementoptions)
|
|
419
|
+
- [StripeEventType](README.md#stripeeventtype)
|
|
414
420
|
|
|
415
421
|
### Functions
|
|
416
422
|
|
|
@@ -698,6 +704,12 @@ ___
|
|
|
698
704
|
|
|
699
705
|
Ƭ **StripeElementOptions**: [`CardElementOptions`](interfaces/CardElementOptions.md) \| [`CardExpiryElementOptions`](interfaces/CardExpiryElementOptions.md) \| [`CardNumberElementOptions`](interfaces/CardNumberElementOptions.md) \| [`CardCvcElementOptions`](interfaces/CardCvcElementOptions.md) \| [`IdealElementOptions`](interfaces/IdealElementOptions.md) \| [`IbanElementOptions`](interfaces/IbanElementOptions.md) \| [`ZipCodeElementOptions`](interfaces/ZipCodeElementOptions.md)
|
|
700
706
|
|
|
707
|
+
___
|
|
708
|
+
|
|
709
|
+
### StripeEventType
|
|
710
|
+
|
|
711
|
+
Ƭ **StripeEventType**: [`StripeShippingEvent`](interfaces/StripeShippingEvent.md) \| [`StripeCustomerEvent`](interfaces/StripeCustomerEvent.md)
|
|
712
|
+
|
|
701
713
|
## Functions
|
|
702
714
|
|
|
703
715
|
### createCheckoutButtonInitializer
|
|
@@ -41,6 +41,7 @@ information in order to initialize the customer step of checkout.
|
|
|
41
41
|
- [masterpass](BaseCustomerInitializeOptions.md#masterpass)
|
|
42
42
|
- [methodId](BaseCustomerInitializeOptions.md#methodid)
|
|
43
43
|
- [params](BaseCustomerInitializeOptions.md#params)
|
|
44
|
+
- [stripeupe](BaseCustomerInitializeOptions.md#stripeupe)
|
|
44
45
|
- [timeout](BaseCustomerInitializeOptions.md#timeout)
|
|
45
46
|
|
|
46
47
|
## Properties
|
|
@@ -202,6 +203,15 @@ The parameters of the request, if required.
|
|
|
202
203
|
|
|
203
204
|
___
|
|
204
205
|
|
|
206
|
+
### stripeupe
|
|
207
|
+
|
|
208
|
+
• `Optional` **stripeupe**: [`StripeUPECustomerInitializeOptions`](StripeUPECustomerInitializeOptions.md)
|
|
209
|
+
|
|
210
|
+
The options that are required to initialize the Customer Stripe Upe payment method.
|
|
211
|
+
They can be omitted unless you need to support Customer Stripe Upe.
|
|
212
|
+
|
|
213
|
+
___
|
|
214
|
+
|
|
205
215
|
### timeout
|
|
206
216
|
|
|
207
217
|
• `Optional` **timeout**: `default`
|
|
@@ -31,6 +31,7 @@ step of checkout.
|
|
|
31
31
|
- [amazonpay](ShippingInitializeOptions.md#amazonpay)
|
|
32
32
|
- [methodId](ShippingInitializeOptions.md#methodid)
|
|
33
33
|
- [params](ShippingInitializeOptions.md#params)
|
|
34
|
+
- [stripeupe](ShippingInitializeOptions.md#stripeupe)
|
|
34
35
|
- [timeout](ShippingInitializeOptions.md#timeout)
|
|
35
36
|
|
|
36
37
|
## Properties
|
|
@@ -75,6 +76,15 @@ The parameters of the request, if required.
|
|
|
75
76
|
|
|
76
77
|
___
|
|
77
78
|
|
|
79
|
+
### stripeupe
|
|
80
|
+
|
|
81
|
+
• `Optional` **stripeupe**: [`StripeUPEShippingInitializeOptions`](StripeUPEShippingInitializeOptions.md)
|
|
82
|
+
|
|
83
|
+
The options that are required to initialize the shipping step of checkout
|
|
84
|
+
when using Stripe Upe Link.
|
|
85
|
+
|
|
86
|
+
___
|
|
87
|
+
|
|
78
88
|
### timeout
|
|
79
89
|
|
|
80
90
|
• `Optional` **timeout**: `default`
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
[@bigcommerce/checkout-sdk](../README.md) / StripeCustomerEvent
|
|
2
|
+
|
|
3
|
+
# Interface: StripeCustomerEvent
|
|
4
|
+
|
|
5
|
+
## Hierarchy
|
|
6
|
+
|
|
7
|
+
- [`StripeEvent`](StripeEvent.md)
|
|
8
|
+
|
|
9
|
+
↳ **`StripeCustomerEvent`**
|
|
10
|
+
|
|
11
|
+
## Table of contents
|
|
12
|
+
|
|
13
|
+
### Properties
|
|
14
|
+
|
|
15
|
+
- [authenticated](StripeCustomerEvent.md#authenticated)
|
|
16
|
+
- [collapsed](StripeCustomerEvent.md#collapsed)
|
|
17
|
+
- [complete](StripeCustomerEvent.md#complete)
|
|
18
|
+
- [elementType](StripeCustomerEvent.md#elementtype)
|
|
19
|
+
- [empty](StripeCustomerEvent.md#empty)
|
|
20
|
+
- [value](StripeCustomerEvent.md#value)
|
|
21
|
+
|
|
22
|
+
## Properties
|
|
23
|
+
|
|
24
|
+
### authenticated
|
|
25
|
+
|
|
26
|
+
• **authenticated**: `boolean`
|
|
27
|
+
|
|
28
|
+
___
|
|
29
|
+
|
|
30
|
+
### collapsed
|
|
31
|
+
|
|
32
|
+
• `Optional` **collapsed**: `boolean`
|
|
33
|
+
|
|
34
|
+
___
|
|
35
|
+
|
|
36
|
+
### complete
|
|
37
|
+
|
|
38
|
+
• **complete**: `boolean`
|
|
39
|
+
|
|
40
|
+
#### Inherited from
|
|
41
|
+
|
|
42
|
+
[StripeEvent](StripeEvent.md).[complete](StripeEvent.md#complete)
|
|
43
|
+
|
|
44
|
+
___
|
|
45
|
+
|
|
46
|
+
### elementType
|
|
47
|
+
|
|
48
|
+
• **elementType**: `string`
|
|
49
|
+
|
|
50
|
+
#### Inherited from
|
|
51
|
+
|
|
52
|
+
[StripeEvent](StripeEvent.md).[elementType](StripeEvent.md#elementtype)
|
|
53
|
+
|
|
54
|
+
___
|
|
55
|
+
|
|
56
|
+
### empty
|
|
57
|
+
|
|
58
|
+
• **empty**: `boolean`
|
|
59
|
+
|
|
60
|
+
#### Inherited from
|
|
61
|
+
|
|
62
|
+
[StripeEvent](StripeEvent.md).[empty](StripeEvent.md#empty)
|
|
63
|
+
|
|
64
|
+
___
|
|
65
|
+
|
|
66
|
+
### value
|
|
67
|
+
|
|
68
|
+
• **value**: `Object`
|
|
69
|
+
|
|
70
|
+
#### Type declaration
|
|
71
|
+
|
|
72
|
+
| Name | Type |
|
|
73
|
+
| :------ | :------ |
|
|
74
|
+
| `email` | `string` |
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
[@bigcommerce/checkout-sdk](../README.md) / StripeEvent
|
|
2
|
+
|
|
3
|
+
# Interface: StripeEvent
|
|
4
|
+
|
|
5
|
+
## Hierarchy
|
|
6
|
+
|
|
7
|
+
- **`StripeEvent`**
|
|
8
|
+
|
|
9
|
+
↳ [`StripeCustomerEvent`](StripeCustomerEvent.md)
|
|
10
|
+
|
|
11
|
+
↳ [`StripeShippingEvent`](StripeShippingEvent.md)
|
|
12
|
+
|
|
13
|
+
## Table of contents
|
|
14
|
+
|
|
15
|
+
### Properties
|
|
16
|
+
|
|
17
|
+
- [complete](StripeEvent.md#complete)
|
|
18
|
+
- [elementType](StripeEvent.md#elementtype)
|
|
19
|
+
- [empty](StripeEvent.md#empty)
|
|
20
|
+
|
|
21
|
+
## Properties
|
|
22
|
+
|
|
23
|
+
### complete
|
|
24
|
+
|
|
25
|
+
• **complete**: `boolean`
|
|
26
|
+
|
|
27
|
+
___
|
|
28
|
+
|
|
29
|
+
### elementType
|
|
30
|
+
|
|
31
|
+
• **elementType**: `string`
|
|
32
|
+
|
|
33
|
+
___
|
|
34
|
+
|
|
35
|
+
### empty
|
|
36
|
+
|
|
37
|
+
• **empty**: `boolean`
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
[@bigcommerce/checkout-sdk](../README.md) / StripeShippingEvent
|
|
2
|
+
|
|
3
|
+
# Interface: StripeShippingEvent
|
|
4
|
+
|
|
5
|
+
## Hierarchy
|
|
6
|
+
|
|
7
|
+
- [`StripeEvent`](StripeEvent.md)
|
|
8
|
+
|
|
9
|
+
↳ **`StripeShippingEvent`**
|
|
10
|
+
|
|
11
|
+
## Table of contents
|
|
12
|
+
|
|
13
|
+
### Properties
|
|
14
|
+
|
|
15
|
+
- [complete](StripeShippingEvent.md#complete)
|
|
16
|
+
- [elementType](StripeShippingEvent.md#elementtype)
|
|
17
|
+
- [empty](StripeShippingEvent.md#empty)
|
|
18
|
+
- [isNewAddress](StripeShippingEvent.md#isnewaddress)
|
|
19
|
+
- [value](StripeShippingEvent.md#value)
|
|
20
|
+
|
|
21
|
+
## Properties
|
|
22
|
+
|
|
23
|
+
### complete
|
|
24
|
+
|
|
25
|
+
• **complete**: `boolean`
|
|
26
|
+
|
|
27
|
+
#### Inherited from
|
|
28
|
+
|
|
29
|
+
[StripeEvent](StripeEvent.md).[complete](StripeEvent.md#complete)
|
|
30
|
+
|
|
31
|
+
___
|
|
32
|
+
|
|
33
|
+
### elementType
|
|
34
|
+
|
|
35
|
+
• **elementType**: `string`
|
|
36
|
+
|
|
37
|
+
#### Inherited from
|
|
38
|
+
|
|
39
|
+
[StripeEvent](StripeEvent.md).[elementType](StripeEvent.md#elementtype)
|
|
40
|
+
|
|
41
|
+
___
|
|
42
|
+
|
|
43
|
+
### empty
|
|
44
|
+
|
|
45
|
+
• **empty**: `boolean`
|
|
46
|
+
|
|
47
|
+
#### Inherited from
|
|
48
|
+
|
|
49
|
+
[StripeEvent](StripeEvent.md).[empty](StripeEvent.md#empty)
|
|
50
|
+
|
|
51
|
+
___
|
|
52
|
+
|
|
53
|
+
### isNewAddress
|
|
54
|
+
|
|
55
|
+
• `Optional` **isNewAddress**: `boolean`
|
|
56
|
+
|
|
57
|
+
___
|
|
58
|
+
|
|
59
|
+
### value
|
|
60
|
+
|
|
61
|
+
• **value**: `Object`
|
|
62
|
+
|
|
63
|
+
#### Type declaration
|
|
64
|
+
|
|
65
|
+
| Name | Type |
|
|
66
|
+
| :------ | :------ |
|
|
67
|
+
| `address` | `Object` |
|
|
68
|
+
| `address.city` | `string` |
|
|
69
|
+
| `address.country` | `string` |
|
|
70
|
+
| `address.line1` | `string` |
|
|
71
|
+
| `address.line2?` | `string` |
|
|
72
|
+
| `address.postal_code` | `string` |
|
|
73
|
+
| `address.state` | `string` |
|
|
74
|
+
| `name` | `string` |
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
[@bigcommerce/checkout-sdk](../README.md) / StripeUPECustomerInitializeOptions
|
|
2
|
+
|
|
3
|
+
# Interface: StripeUPECustomerInitializeOptions
|
|
4
|
+
|
|
5
|
+
## Table of contents
|
|
6
|
+
|
|
7
|
+
### Properties
|
|
8
|
+
|
|
9
|
+
- [container](StripeUPECustomerInitializeOptions.md#container)
|
|
10
|
+
- [gatewayId](StripeUPECustomerInitializeOptions.md#gatewayid)
|
|
11
|
+
- [methodId](StripeUPECustomerInitializeOptions.md#methodid)
|
|
12
|
+
|
|
13
|
+
### Methods
|
|
14
|
+
|
|
15
|
+
- [getStyles](StripeUPECustomerInitializeOptions.md#getstyles)
|
|
16
|
+
- [isLoading](StripeUPECustomerInitializeOptions.md#isloading)
|
|
17
|
+
- [onEmailChange](StripeUPECustomerInitializeOptions.md#onemailchange)
|
|
18
|
+
|
|
19
|
+
## Properties
|
|
20
|
+
|
|
21
|
+
### container
|
|
22
|
+
|
|
23
|
+
• **container**: `string`
|
|
24
|
+
|
|
25
|
+
The ID of a container which the stripe iframe should be inserted.
|
|
26
|
+
|
|
27
|
+
___
|
|
28
|
+
|
|
29
|
+
### gatewayId
|
|
30
|
+
|
|
31
|
+
• **gatewayId**: `string`
|
|
32
|
+
|
|
33
|
+
The identifier of the payment provider providing the payment method. This
|
|
34
|
+
option is only required if the provider offers multiple payment options.
|
|
35
|
+
i.e.: Stripeupe and Klarna.
|
|
36
|
+
|
|
37
|
+
___
|
|
38
|
+
|
|
39
|
+
### methodId
|
|
40
|
+
|
|
41
|
+
• **methodId**: `string`
|
|
42
|
+
|
|
43
|
+
The identifier of the payment method.
|
|
44
|
+
|
|
45
|
+
## Methods
|
|
46
|
+
|
|
47
|
+
### getStyles
|
|
48
|
+
|
|
49
|
+
▸ `Optional` **getStyles**(): `Object`
|
|
50
|
+
|
|
51
|
+
get styles from store theme
|
|
52
|
+
|
|
53
|
+
#### Returns
|
|
54
|
+
|
|
55
|
+
`Object`
|
|
56
|
+
|
|
57
|
+
___
|
|
58
|
+
|
|
59
|
+
### isLoading
|
|
60
|
+
|
|
61
|
+
▸ **isLoading**(`mounted`): `void`
|
|
62
|
+
|
|
63
|
+
A callback that gets called when Stripe Link Authentication Element is Loaded.
|
|
64
|
+
|
|
65
|
+
#### Parameters
|
|
66
|
+
|
|
67
|
+
| Name | Type |
|
|
68
|
+
| :------ | :------ |
|
|
69
|
+
| `mounted` | `boolean` |
|
|
70
|
+
|
|
71
|
+
#### Returns
|
|
72
|
+
|
|
73
|
+
`void`
|
|
74
|
+
|
|
75
|
+
___
|
|
76
|
+
|
|
77
|
+
### onEmailChange
|
|
78
|
+
|
|
79
|
+
▸ **onEmailChange**(`authenticated`, `email`): `void`
|
|
80
|
+
|
|
81
|
+
A callback that gets called whenever the Stripe Link Authentication Element's value changes.
|
|
82
|
+
|
|
83
|
+
#### Parameters
|
|
84
|
+
|
|
85
|
+
| Name | Type | Description |
|
|
86
|
+
| :------ | :------ | :------ |
|
|
87
|
+
| `authenticated` | `boolean` | if the email is authenticated on Stripe. |
|
|
88
|
+
| `email` | `string` | The new value of the email. |
|
|
89
|
+
|
|
90
|
+
#### Returns
|
|
91
|
+
|
|
92
|
+
`void`
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
[@bigcommerce/checkout-sdk](../README.md) / StripeUPEShippingInitializeOptions
|
|
2
|
+
|
|
3
|
+
# Interface: StripeUPEShippingInitializeOptions
|
|
4
|
+
|
|
5
|
+
A set of options that are required to initialize the shipping step of
|
|
6
|
+
checkout in order to support StripeUpe.
|
|
7
|
+
|
|
8
|
+
When StripeUpe is initialized, an iframe will be inserted into the DOM. The
|
|
9
|
+
iframe has a list of shipping addresses for the customer to choose from.
|
|
10
|
+
|
|
11
|
+
## Table of contents
|
|
12
|
+
|
|
13
|
+
### Properties
|
|
14
|
+
|
|
15
|
+
- [availableCountries](StripeUPEShippingInitializeOptions.md#availablecountries)
|
|
16
|
+
- [container](StripeUPEShippingInitializeOptions.md#container)
|
|
17
|
+
- [gatewayId](StripeUPEShippingInitializeOptions.md#gatewayid)
|
|
18
|
+
- [methodId](StripeUPEShippingInitializeOptions.md#methodid)
|
|
19
|
+
|
|
20
|
+
### Methods
|
|
21
|
+
|
|
22
|
+
- [getStyles](StripeUPEShippingInitializeOptions.md#getstyles)
|
|
23
|
+
- [onChangeShipping](StripeUPEShippingInitializeOptions.md#onchangeshipping)
|
|
24
|
+
|
|
25
|
+
## Properties
|
|
26
|
+
|
|
27
|
+
### availableCountries
|
|
28
|
+
|
|
29
|
+
• **availableCountries**: `string`
|
|
30
|
+
|
|
31
|
+
Available countries configured on BC shipping setup.
|
|
32
|
+
|
|
33
|
+
___
|
|
34
|
+
|
|
35
|
+
### container
|
|
36
|
+
|
|
37
|
+
• `Optional` **container**: `string`
|
|
38
|
+
|
|
39
|
+
The ID of a container which the stripe iframe should be inserted.
|
|
40
|
+
|
|
41
|
+
___
|
|
42
|
+
|
|
43
|
+
### gatewayId
|
|
44
|
+
|
|
45
|
+
• **gatewayId**: `string`
|
|
46
|
+
|
|
47
|
+
The identifier of the payment provider providing the payment method. This
|
|
48
|
+
option is only required if the provider offers multiple payment options.
|
|
49
|
+
i.e.: Stripeupe and Klarna.
|
|
50
|
+
|
|
51
|
+
___
|
|
52
|
+
|
|
53
|
+
### methodId
|
|
54
|
+
|
|
55
|
+
• **methodId**: `string`
|
|
56
|
+
|
|
57
|
+
The identifier of the payment method.
|
|
58
|
+
|
|
59
|
+
## Methods
|
|
60
|
+
|
|
61
|
+
### getStyles
|
|
62
|
+
|
|
63
|
+
▸ `Optional` **getStyles**(): `Object`
|
|
64
|
+
|
|
65
|
+
get styles from store theme
|
|
66
|
+
|
|
67
|
+
#### Returns
|
|
68
|
+
|
|
69
|
+
`Object`
|
|
70
|
+
|
|
71
|
+
___
|
|
72
|
+
|
|
73
|
+
### onChangeShipping
|
|
74
|
+
|
|
75
|
+
▸ **onChangeShipping**(`shipping`): `void`
|
|
76
|
+
|
|
77
|
+
A callback that gets called whenever the Stripe Link Shipping Element's object is completed.
|
|
78
|
+
|
|
79
|
+
#### Parameters
|
|
80
|
+
|
|
81
|
+
| Name | Type |
|
|
82
|
+
| :------ | :------ |
|
|
83
|
+
| `shipping` | [`StripeEventType`](../README.md#stripeeventtype) |
|
|
84
|
+
|
|
85
|
+
#### Returns
|
|
86
|
+
|
|
87
|
+
`void`
|