Skip to content

Commit 56004eb

Browse files
committed
Modified section about configuring tax provider settings to streamline it for integrators
1 parent 7174854 commit 56004eb

File tree

1 file changed

+13
-8
lines changed

1 file changed

+13
-8
lines changed

docs/integrations/tax.mdx

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -106,22 +106,27 @@ You will be ready to set up a connection with the Tax Provider API when all of t
106106
* During the [OAuth flow](#installing-the-app), the app requests that the merchant authorize read and write permissions on the Information and Settings API scopes.
107107
* During the [OAuth flow](#installing-the-app), you received and stored the `client_id` and `access_token`.
108108

109-
For context, the [Tax Provider API Connection endpoints](/docs/rest-contracts/tax-app-connection) add a layer of security for your app. You can use these basic credentials to authenticate API requests that you receive from stores so that you can reject unauthorized requests.
110-
111-
An account login flow lets you capture basic authentication credentials from merchants. We recommend that you provide a login flow within your app iFrame so that you can choose your own authentication method. You can also provide an account registration flow in your iFrame to help merchants create a new tax provider account. Learn more about [designing the app UI](/docs/integrations/apps/guide/ui).
112-
113-
We recommend calling the [Update Connection](/docs/rest-contracts/tax-app-connection#update-a-connection) endpoint immediately after the merchant installs your app and you authenticate the merchant's account credentials. Otherwise, your tax provider will not be displayed when merchants navigate to the **Settings > Setup > Tax** page in the control panel. You will need to include `store_hash`, `provider_id`, and `X-Auth-Token`(`access_token`) values.
114-
115109
## Configure tax provider settings in the control panel
116110

117-
After you install your app and send basic authentication credentials through the [Update Connection](/docs/rest-contracts/tax-app-connection#update-a-connection) request, merchants can adjust their tax provider settings to activate supported functions on their store.
111+
To make your tax provider visible in the merchant control panel, you will need to:
112+
113+
* Install your app on the store.
114+
* Send basic authentication credentials through the [Update Connection](/docs/rest-contracts/tax-app-connection#update-a-connection) endpoint. For more details on the tax connection endpoints, see [Tax Connection Endpoints](#tax-connection-endpoints).
118115

119-
Merchants can adjust these settings by navigating to **Settings > Setup > Tax > _TaxProviderName_** in the control panel.
116+
After this, merchants can adjust their tax provider settings by navigating to **Settings > Setup > Tax > _TaxProviderName_** in the control panel.
120117

121118
Before you can provide tax estimates, the merchant must choose which regions they want you to service. The control panel displays a list of countries and subdivisions that you support.
122119

123120
If you support document submission, the merchant can choose to select the **Submit Order Data** checkbox. This allows merchants to submit tax documents for supported transactions on their store.
124121

122+
## Tax Connection Endpoints
123+
124+
The [Tax Provider API Connection endpoints](/docs/rest-contracts/tax-app-connection) add a layer of security for your app. You can use these basic credentials to authenticate API requests that you receive from stores so that you can reject unauthorized requests.
125+
126+
An account login flow lets you capture basic authentication credentials from merchants. We recommend that you provide a login flow within your app iFrame so that you can choose your own authentication method. You can also provide an account registration flow in your iFrame to help merchants create a new tax provider account. Learn more about [designing the app UI](/docs/integrations/apps/guide/ui).
127+
128+
We recommend calling the [Update Connection](/docs/rest-contracts/tax-app-connection#update-a-connection) endpoint immediately after the merchant installs your app, and you authenticate the merchant's account credentials. Otherwise, your tax provider will not be displayed when merchants navigate to the **Settings > Setup > Tax** page in the control panel. You will need to include `store_hash`, `provider_id`, and `X-Auth-Token`(`access_token`) values.
129+
125130
## Tax estimation
126131

127132
### When tax estimates are requested

0 commit comments

Comments
 (0)