Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/dev-tools/bridge/v1/generate-token.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ An API to generate tokens, which are used to authorise any other API requests ma

### Note on JWT authentication

The generate token API works only with <a href="oauth">OAuth keys</a>. If you have implemented <a href="/dev-tools/bridge/org-settings/api-keys/jwt" target="_blank"> JWT auth </a> for Setu hosted endpoints, we recommend upgrading to OAuth soon. We support JWT auth but will not build any further features for it.
The generate token API works only with <a href="oauth">OAuth keys</a>. If you have implemented <a href="/dev-tools/bridge/overview" target="_blank"> JWT auth </a> for Setu hosted endpoints, we recommend upgrading to OAuth soon. We support JWT auth but will not build any further features for it.

**Please note**, that switching to OAuth will mean a change to all endpoints hosted by Setu. If the previous endpoint was `https://uat.setu.co/api/<path>`, it would change to `https://uat.setu.co/api/v2/<path>`—note the `/v2` added before the `<path>`.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The JSON Web Token mechanism is used for securely communicating with Setu. It is
The <a href="https://jwt.io/" target="_blank">JWT website ↗</a> covers the basics of how it works and the concepts involved. This guide provides a simple description of how JWT is implemented at Setu.
&nbsp;

**Please note**, while Setu supports JWT authentication, features like generating keys, using one key to access multiple configurations etc, will not be supported for JWT keys. Instead, use the more secure <a href="/dev-tools/bridge/org-settings/api-keys/oauth">OAuth API keys ↗</a> to access these features.
**Please note**, while Setu supports JWT authentication, features like generating keys, using one key to access multiple configurations etc, will not be supported for JWT keys. Instead, use the more secure <a href="/dev-tools/bridge/overview">OAuth API keys ↗</a> to access these features.

<hr class="primary" />

Expand All @@ -22,7 +22,7 @@ A partner needs to authenticate API requests made to Setu. One supported method

For Setu's products, JWT keys have a one-to-one mapping with individual product configurations. Essentially, each of your configurations come with their own JWT key that you can use to authorise API requests.

If you are an Admin for your Bridge account, you should be able to see the API keys card under “Org settings” in the left panel. Click the JWT keys card to view keys for all your product configs. <a href="/dev-tools/bridge/org-settings/api-keys/jwt" target="_blank">Read more ↗</a>.
If you are an Admin for your Bridge account, you should be able to see the API keys card under “Org settings” in the left panel. Click the JWT keys card to view keys for all your product configs. <a href="/dev-tools/bridge/overview" target="_blank">Read more ↗</a>.

Read more below to understand the JWT format supported by Setu.

Expand Down
2 changes: 1 addition & 1 deletion content/dev-tools/bridge/v1/org-settings/api-keys/jwt.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ visible_in_sidebar: true

<Callout type="warning">
We recommend using{" "}
<a href="/dev-tools/bridge/org-settings/api-keys/oauth" target="_blank">
<a href="/dev-tools/bridge/overview" target="_blank">
OAuth keys
</a>{" "}
instead, which come with features like the ability to access multiple products
Expand Down
4 changes: 2 additions & 2 deletions content/payments/bbps/resources/jwt.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ For Setu products, JWT keys have a one-to-one mapping with individual product co

<Callout type="warning">
While we support JWT auth, we recommend using the more secure{" "}
<a href="/dev-tools/bridge/org-settings/api-keys/oauth" target="_blank">
<a href="/dev-tools/bridge/overview" target="_blank">
OAuth keys
</a>
, which come with features like the ability to access multiple products with the
Expand All @@ -134,7 +134,7 @@ For Setu products, JWT keys have a one-to-one mapping with individual product co

A merchant will call Setu APIs for creating payment links, checking link status, for fetching reports etc and can use JWT to authenticate such requests with Setu.

If you are an Admin for your Bridge account, you should be able to see the API keys card under “Org settings” in the left panel. Click the JWT keys card to view keys for all your product configs. <a href="/dev-tools/bridge/org-settings/api-keys/jwt" target="_blank">Read more ↗</a>
If you are an Admin for your Bridge account, you should be able to see the API keys card under “Org settings” in the left panel. Click the JWT keys card to view keys for all your product configs. <a href="/dev-tools/bridge/overview" target="_blank">Read more ↗</a>

<hr class="primary" />

Expand Down
4 changes: 2 additions & 2 deletions content/payments/bbps/resources/oauth.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ On clicking “Generate new key”, you should see a simple form

The “Generate key” button is enabled once all the fields are filled. Click it, and you should see the `clientID` and `secret` for this key.

And done! You can now use this key to make API requests to Setu. <a href="/dev-tools/bridge/org-settings/api-keys/oauth" target="_blank">Read more ↗</a> on supported features for OAuth keys.
And done! You can now use this key to make API requests to Setu. <a href="/dev-tools/bridge/overview" target="_blank">Read more ↗</a> on supported features for OAuth keys.

<hr class="primary" />

Expand Down Expand Up @@ -246,4 +246,4 @@ Implement a workflow to generate new token when the old one expires. The general
- Generate new token with stored `clientID` and `secret` when token has expired. If the API you call returns `401 unauthorized`, it could be an indication that the token has expired.
- Store the newly generated token and use for subsequent API calls.

<WasPageHelpful />
<WasPageHelpful />
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ Depending on the platform you have chosen, please read the appropriate guide to
- <a href="/payments/billpay/custom-payment/iOS" target="_blank">
iOS
</a>
- <a href="/payments/billpay/custom-payment/cross-platform" target="_blank">
- <a href="/payments/billpay/pre-built-screens/custom-payment/cross-platform" target="_blank">
Cross platform
</a>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ visible_in_sidebar: true
<Callout type="tip">
This quickstart explains how to integrate when you opt for your own payment
gateway. Use{" "}
<a href="/payments/billpay/quickstart/iOS" target="_blank">
<a href="/payments/billpay/pre-built-screens/quickstart/iOS" target="_blank">
this guide
</a>{" "}
for Setu’s default UPI payment option.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ The above request will return URL based on the input params. Here’s a sample

The link returned by the API should be loaded within Android in an activity class with a webview component.

If you’re using a cross platform solution—like Flutter, React Native, Ionic—look at the code snippets provided <a href="/payments/billpay/quickstart/cross-platform" target="_blank">here</a>.
If you’re using a cross platform solution—like Flutter, React Native, Ionic—look at the code snippets provided <a href="/payments/billpay/pre-built-screens/quickstart/cross-platform" target="_blank">here</a>.

<CodeBlockWithCopy language="java">
{`public class DisplayWebView extends AppCompatActivity {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ Depending on the platform you have chosen, please read the appropriate guide to
- <a href="/payments/billpay/custom-payment/iOS" target="_blank">
iOS
</a>
- <a href="/payments/billpay/custom-payment/cross-platform" target="_blank">
- <a href="/payments/billpay/pre-built-screens/custom-payment/cross-platform" target="_blank">
Cross platform
</a>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ visible_in_sidebar: true
<Callout type="tip">
This quickstart explains how to integrate when you opt for your own payment
gateway. Use{" "}
<a href="/payments/billpay/quickstart/iOS" target="_blank">
<a href="/payments/billpay/pre-built-screens/quickstart/iOS" target="_blank">
this guide
</a>{" "}
for Setu’s default UPI payment option.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ The above request will return URL based on the input params. Here’s a sample

The link returned by the API should be loaded within Android in an activity class with a webview component.

If you’re using a cross platform solution—like Flutter, React Native, Ionic—look at the code snippets provided <a href="/payments/billpay/quickstart/cross-platform" target="_blank">here</a>.
If you’re using a cross platform solution—like Flutter, React Native, Ionic—look at the code snippets provided <a href="/payments/billpay/pre-built-screens/quickstart/cross-platform" target="_blank">here</a>.

<CodeBlockWithCopy language="java">
{`public class DisplayWebView extends AppCompatActivity {
Expand Down
2 changes: 1 addition & 1 deletion content/payments/umap/refunds-disputes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ UPI Setu sends notifications to merchants for the following events

- `dispute_created`

Read more about dispute status notifications <a href="/payments/umap/notifications/disputes">here</a>
Read more about dispute status notifications <a href="/payments/umap/overview">here</a>

###### Step 2 - Respond to dispute as a merchant

Expand Down
4 changes: 2 additions & 2 deletions content/payments/upi-deeplinks/resources/jwt.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ For Setu products, JWT keys have a one-to-one mapping with individual product co

<Callout type="warning">
While we support JWT auth, we recommend using the more secure{" "}
<a href="/dev-tools/bridge/org-settings/api-keys/oauth" target="_blank">
<a href="/dev-tools/bridge/overview" target="_blank">
OAuth keys
</a>
, which come with features like the ability to access multiple products with the
Expand All @@ -134,7 +134,7 @@ For Setu products, JWT keys have a one-to-one mapping with individual product co

A merchant will call Setu APIs for creating payment links, checking link status, for fetching reports etc and can use JWT to authenticate such requests with Setu.

If you are an Admin for your Bridge account, you should be able to see the API keys card under “Org settings” in the left panel. Click the JWT keys card to view keys for all your product configs. <a href="/dev-tools/bridge/org-settings/api-keys/jwt" target="_blank">Read more ↗</a>
If you are an Admin for your Bridge account, you should be able to see the API keys card under “Org settings” in the left panel. Click the JWT keys card to view keys for all your product configs. <a href="/dev-tools/bridge/overview" target="_blank">Read more ↗</a>

<hr class="primary" />

Expand Down
2 changes: 1 addition & 1 deletion content/payments/upi-deeplinks/resources/oauth.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ On clicking “Generate new key”, you should see a simple form

The “Generate key” button is enabled once all the fields are filled. Click it, and you should see the `clientID` and `secret` for this key.

And done! You can now use this key to make API requests to Setu. <a href="/dev-tools/bridge/org-settings/api-keys/oauth" target="_blank">Read more ↗</a> on supported features for OAuth keys.
And done! You can now use this key to make API requests to Setu. <a href="/dev-tools/bridge/overview" target="_blank">Read more ↗</a> on supported features for OAuth keys.

<hr class="primary" />

Expand Down
Loading