Not a Developer?
Check out our no-code app builder, to get you started in minutes.
Use our Sandbox environment to build your integration. We offer dummy data that mimics that of real-world use cases, which means you can test out all the endpoints, use the widget, and implement webhooks - just the same as with real-world data!
All you need to get started with the Sandbox environment is to get your API keys. We really recommend that you start creating your integration in this environment.
client_token - A unique identifier used to integrate the Okra widget
Public API Key - Gives you access to data in real-time, used with client token during widget implementation.
Secret Key - A unique set of string of numbers or letters used only during API implementation
Sandbox - Get started with test credentials that mimic that of real-world use cases
Production - Launch your app with live credentials.
If you get stuck at any point in the Quickstart, help is just a click away! Ask other developers in our Slack developer community.
After you have tested your integration in the Sandbox environment and are ready to go live, you'll need to request access to our Production environment. After you request access, our Sales Team will get in contact with you to schedule a meeting just to make sure your needs are satisfied, and then you'll just need to go through a process with one of our engineers to make sure that your integration is running optimally. Before meeting with one of our engineers, follow our Integration checklist.
Once your integration is certified, all you'll need to do is:
- Request Production API keys (and change your Sandbox API keys in the code to these new ones)
- Change the base URL that you make requests to from
- If you're using webhooks, make sure to set a Production URL for your webhooks.
In this guide, we'll get you set up with API keys, a Postman collection, and run you through a simple flow with our API so you can see how easy it is to access a whole world of information!
- Go to the Okra Dashboard sign-up page and fill in the required fields.
- Check your inbox for an email from us and confirm your email address.
The subject line will be: [Okra] Please Confirm Your E-mail Address
✳️ Done! Once you click on the link in the email, you'll be redirected to the Okra dashboard! In the dashboard, you can set up your account, check your activity logs, and find your Okra API keys.
With your API keys in hand, let's get you up and running with Postman 📬.
We've created a public Postman workspace so that you can quickly and easily start testing what data you can get using Okra. In this article, you'll learn how to install and configure our collection.
Make sure you've installed the Postman App for Windows, Mac, or Chrome and have logged into your Postman account.
To use Okra API collection:
- Go to Okra's Postman workspace and click Watch. This way, if we ever make a change to the collection, you'll be automatically notified and you'll be able to pull the changes into your fork.
- Click on Fork to fork the collection into your own private workspace.
✳️ Done! Let's quickly configure Postman so that you can easily use our API.
Our Postman collections make use of environment variables to customize the requests that are sent. You can read more about environments in Postman's setting up an environment with variables article.
To create your environment variables:
- In Postman, click the eye icon.
- In the Environment section, click Add.
- Name your Environment, for example, Okra Sandbox.
- Add the following environment variables:
API_KEY: your sandbox API Key
secret: your sandbox secret(token).
Make sure that your
baseUrlare properly stored as the initial value AND current value. This is important to prevent potential errors
- Rename the environment to Okra Sandbox
- Click Save
✳️ Awesome! But before we go on, let's make sure that everything is working just fine with a simple call.
Just to make sure you've set everything up correctly, let's see that you can list all the banks in our Sandbox environment.
- Make sure that you select your Okra Sandbox environment.
- In the Okra API folder, select Bank → GET List.
- Click Send.
If everything is correctly set up, you should see a whole host of banks appear!
Let's see how you can link a bank account using the sandbox environment and with test credentials.
The steps towards linking your bank account using Okra involves;
Username - Jude123 Password - Lily #Bank - ALAT #LoginMethod - Internet Banking
Your company name of that of the app
The environment, in our case it's production-sandbox since we're on the sandbox environment
public API key
The public key in your dashboard
The client token in your dashboard
It involves an array of products you want to retrieve from a customer bank account after linking.
onSuccess and onClose are the events during widget implementation, to keep it simple, we console.log the data from the widget.
Congratulations ✳️, you have completed the Okra Quickstart! From here, we invite you to modify the Quickstart code in order to get more practice with the Okra API.
From here, the next directions you can go in now includes:
If you're not sure which Okra products you want to use, see Explore by use case for a mapping of common use cases to fit your products.
This Quickstart guide only covered working with web apps. If your app is targeted towards mobile users, check out our list of libraries and SDKs.
Updated about 2 months ago