> 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/partnership-apis/sample-clients.md).

# Sample Clients

## 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://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2F9slSMA2DzhrqOZKPbr2A%2Fimage.png?alt=media&amp;token=50cd7264-d052-48ec-81fa-53c5f4a0c923" 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://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FowQ3HKraN59ord56BB2r%2Fimage.png?alt=media&amp;token=a521c122-fb2a-4583-8191-2f4d7c625516" 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://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FP6JjJdiLbjdjH2LXYAx2%2Fimage.png?alt=media&amp;token=0a0044a4-fa75-4025-ae1a-56abe471b6cb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FR35zm96IUkNb3Ljx8N5Y%2Fimage.png?alt=media&amp;token=10a7ab4d-1b34-4bb5-87b8-d3f5e6ad83f6" 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://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FlLJ9NA6JxtinjIvaBKyS%2Fimage.png?alt=media&amp;token=62bbdfdd-e8fc-401f-b370-463b25c96f8e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FOhvWbCGMa2Yqc3ZkkSH3%2Fimage.png?alt=media&amp;token=df127a54-c395-4dbf-86f6-2c9f2a081199" 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://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FTJDIsXYQvitYIsqDST05%2Fimage.png?alt=media&amp;token=7313f4d2-e559-4d80-bd24-1f7467d9960a" alt=""><figcaption></figcaption></figure>

You should get an OAuth token from the identity server

<figure><img src="https://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FzzGzzoC9BoxK3teXU7Xz%2Fimage.png?alt=media&amp;token=994a60c7-7649-4183-b0e0-d036982da46b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://195384850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh9MuInZ2gBGVzfYaKh0S%2Fuploads%2FLoRdHkof0uoBH0Ni4QOe%2Fimage.png?alt=media&amp;token=0176a2df-94c6-4535-be54-f3a4efd9c81c" alt=""><figcaption></figcaption></figure>

## .NET Sample Client

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

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