# Obtaining API access to Jiko's Sandbox environment

This document outlines the process for obtaining API access to a Jiko's sandbox environment and utilizing a private sandbox "customer" tenant.

Please be aware that the sandbox environment is **not linked to live payment networks**, meaning **it cannot process real funds or initiate actual payments** (withdrawals or third-party transfers). Consequently, any approved transfer requests within this environment **will not be executed**.

## Create a Sandbox account

1. Use the following URL to access Jiko's sandbox sign up page: [https://authentication-portal.sandbox-api.jikoservices.com/sign-up](https://authentication-portal.sandbox-api.jikoservices.com/sign-up)


![Jiko's Authenticaion Portal Sign Up Page](/assets/auth_portal_sign_up.09abe8a60bad774cd65135efa628561c65bc7908751ca9a53bada7781185ad56.9c1bb791.png)

1. Fill in this page and click on “Sign up”.
2. Receive a verification email:


![Jiko's Authentication Portal Verification Email Page](/assets/auth_portal_verification_email.955114f2a836163d3eaf713a602a4703738e3ca7ee91a19f1b57d28eafb11601.9c1bb791.png)

This email is sent from [no-reply@sandbox.jiko.com](mailto:no-reply@sandbox.jiko.com) and invites you to click a verification link. Click this link. For information, this link starts with [https://authentication-portal.sandbox-api.jikoservices.com/sign-up/verify-email?confirmation_code=***](https://authentication-portal.sandbox-api.jikoservices.com/sign-up/verify-email?confirmation_code=***).

1. The following page appears. Enter the credentials chosen on the sign-up page.


![Jiko's Authentication Portal Login Page](/assets/auth_portal_login.65d98f364ac25bf098710247302c0430aef7b236f47b6a6de3d1063b5e446325.9c1bb791.png)

1. Jiko's onboarding page is displayed. Accessing Jiko's sandbox environment **does not require this onboarding form to be filled in/submitted**, so simply notify us that you could successfully see this page, and we will complete the enablement process and create a private sandbox environment for you.


![Jiko's Onboarding Portal Landing Page](/assets/onboarding_portal_landing_page.8b5f27a1b502160de614942f4f097387a234bc2e87495520791c0dfe429b96c0.9c1bb791.png)

Jiko's team will also fund your sandbox customer account with a fake $ deposit:

- Jiko will create a pocket (a pocket represents a pair of bank account and brokerage account) and fund it with a fake $ amount, which will be automatically invested into fake T-bill holdings.
- You can rename this pocket: click on the pocket in Jiko's home page and then on “Edit pocket”.
- You can also create other pockets, via Jiko's UI (“Create pocket”) or API.


Three pockets were created in the example below:

![Jiko's Business Dashboard Portal Landing Page, example with three pockets](/assets/dashboard_three_pockets.f645dc21f450f3dc752c2704f57dea96d57930943492d486d2eedcb853b3b1d3.9c1bb791.png)

## Create API credentials for this Sandbox account

1. Please wait until we notify you that we have created your sandbox environment.
2. Use the following URL to access Jiko's sandbox: [https://business-dashboard.sandbox-api.jikoservices.com](https://business-dashboard.sandbox-api.jikoservices.com), and enter your sandbox credentials.


![Jiko's Authentication Portal Login Page](/assets/auth_portal_login.65d98f364ac25bf098710247302c0430aef7b236f47b6a6de3d1063b5e446325.9c1bb791.png)

1. Click in the top right corner, on the circle representing your user, and then click on menu “Settings”:


![Jiko's Business Dashboard Landing Page, yellow arrow pointing to user](/assets/dashboard_yellow_arrow_to_user.1c6d7973515d1a589111c88b9c3f820954fc410f7d8015e2e2c816ddbac9c86e.9c1bb791.png)

![Jiko's Business Dashboard Landing Page, yellow arrow pointing to user settings](/assets/dashboard_yellow_arrow_to_user_settings.a1f1a09db9dd446e11fc36af0eec9928b30461b0e5940e158b0e6526b01fc708.9c1bb791.png)

1. Click on the icon below to access advanced settings (note: we are in the process of reorganizing this menu structure):


![Jiko's Business Dashboard Settings Page, yellow arrow pointing to external link](/assets/dashboard_settings_page.199ce1d8641e349cef7f464282473a6d605119ef8fa8a601b38a8ad72417d24a.9c1bb791.png)

1. In the submenu below, click on “OAuth Clients”:


![Jiko's Authentication Portal Settings Page, yellow arrow pointing to OAuth clients navigation item](/assets/auth_portal_oauth_clients.b5d9ff6e118fa6f2e5e6d1ffec73960db49075e57486e3e7a9697e7dcbf4c3cc.9c1bb791.png)

1. To create a new OAuth Client, click on button “Create client” and fill in the form below. Where Client name and Description are user-defined fields. Enter your Redirect URIs and choose which scopes to grant access to for this OAuth Client:


![Jiko's Authentication Portal Create OAuth Client form](/assets/auth_portal_create_oauth_client_form.3eb8f3fa74eb1fd11d30da6b4b706716a314ae78861899e2adf9ea2300066ae2.9c1bb791.png)

1. Click on button “Add credentials”: choose from your OAuth Clients, enter a user-defined Name and paste your Public Key.


![Jiko's Authentication Portal Add Credentials form](/assets/auth_portal_add_credentials_form.f7c9536cd5f142a9059b1a65756a610065d661aa42e1dfe680ad2a0d629133b9.9c1bb791.png)

See the [Private Key JWT guide](/products/customer-api/guides/oauth/private-key-jwt) that details how:

- Clients generate a JWT and sign it with their private key.
- Clients send the JWT in the client_assertion parameter.
- The server verifies the JWT using the client's public key.


Let us know if you have any questions.

You now have your API credentials for Jiko's sandbox!