> For the complete documentation index, see [llms.txt](https://apidocs.arionbanki.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.arionbanki.is/business-apis/examples/postman-examples.md).

# Postman Examples

## Set up Postman

For your convenience, we have created a sample Postman client for you to use which can be accessed on our GitHub here:

{% embed url="<https://github.com/arionbanki/Arion-BusinessApi-SampleClient>" %}

## Importing a Collection

A base sample client is available to import for Postman. You can follow the documentation to get it up and running.

To import the collection, simply click import in Postman:

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FYLKtohTOPf7KiE7lrKq6%2Fimage.png?alt=media&amp;token=76e493c6-c029-45a5-bafe-d0b519b03b0f" alt=""><figcaption></figcaption></figure>

Then locate the json file from the cloned repository. File location in repository: **postman\IOBWS 3.0 Cards.postman\_collection.json.** Select it in Postman:

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2Fbfzjs8wwswDxPMW8fc6K%2Fimage.png?alt=media&amp;token=86862590-87fc-46ed-9f6f-be18c74e587e" alt=""><figcaption></figcaption></figure>

## Certificates in Postman

For our Business APIs, you need to have a certificate. To register a certificate in Postman the following is recommended.

Go to **File** and then **Settings**

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2F0z0FZJ9UkpQi77EHWsnC%2Fimage.png?alt=media&amp;token=2629e903-1219-4359-9f7b-fa0cbe37acca" alt=""><figcaption></figcaption></figure>

Next go to **Certificates** and **Add Certificate**

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2F5WkF3QXot8PTMpnicefn%2Fimage.png?alt=media&amp;token=b7729f8b-b146-4c00-bcdb-f607f6fb049c" alt=""><figcaption></figcaption></figure>

There you need to enter the following.

**Host is apigw\.arionbanki.is**

**Register your .pfx certificate**

**Enter your certificate passphrase**

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FPdkBv5vWgjLIzAcxhNhI%2Fimage.png?alt=media&amp;token=a10247a3-49a0-40e3-8e94-4dbab0492536" alt=""><figcaption></figcaption></figure>

You have now registered your certificate. It should now look like this

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FIeSnnRp5kT1ZXzQHT4SB%2Fimage.png?alt=media&amp;token=7b6bae63-36bb-46cf-89fe-a801e4ea856e" alt=""><figcaption></figcaption></figure>

## Authorization - OAuth 2.0

This method shows how the token is received. With this implementation the user needs to get a new access token manually.

The following needs to be configured.

**Access Token URL** - <https://apigw.arionbanki.is/oauth/v2/oauth-token>

**Client ID** - The clientId you get from creating your application in [Developer Portal](https://developer.arionbanki.is/)

**Client Secret** - The clientSecret you get from creating your application in [Developer Portal](https://developer.arionbanki.is/)

**Scope** - The default scopes you get from creating your application in [Developer Portal](https://developer.arionbanki.is/)

Finally click **Get New Access Token**

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FSkCLsmkx47eoHEPmjeQK%2Fimage.png?alt=media&amp;token=79ef59bf-c3e3-49ef-87e5-3416a590d297" alt=""><figcaption></figcaption></figure>

You should get an OAuth token from the identity server

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FNQsjPZEmpcxDTlIjVCOj%2Fimage.png?alt=media&amp;token=b5527c06-b05e-42a3-87ab-045b85b2cfb3" alt=""><figcaption></figcaption></figure>

You can inspect your token and make sure everything is in order

<figure><img src="https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2F8kx8f4XAO2cc30XRwJzd%2Fimage.png?alt=media&amp;token=64655573-2797-4cea-9727-1afc4bf97cb4" alt=""><figcaption></figcaption></figure>