Quickstart Guide

Yapily helps developers adopt Open Banking solutions into their applications. We have APIs to gather account data and initiate account to account payments for an impressive number of banks participating in the Open Banking ecosystem.

Getting started with Yapily typically takes just a few minutes. After following these steps, you'll be ready to start your integration.

1. Sign-up (1 min)

2. Create an Application (1 min)

After creating an account, you'll need to generate a new application.

Go to My Applications and click Add New
Choose a name for your application and click Create
Click Download Secret to download the secret file containing the key (application-uuid) and secret (application-secret)

3. Configure Callback URL (1 min)

You'll need to configure the Application Callback URL for testing. In the Console:

Select your application
Go to Settings and click Add Callback
Add https://display-parameters.com/ to your authorized callbacks

4. Configure Sandbox (2 mins)

In order to test your application you'll need to configure a sandbox in the Console. This allows you perform API requests against a Mock Bank:

Select your application
Go to Institutions and click Add Institution
Search for modelo-sandbox (or change the filter All Environments to Preconfigured Sandbox ) and click Open
Click Select to add modelo-sandbox to your application and select Yes, Preconfigured Credentials

5. Send your first API request (1 min)

Using Postman,
- Create a new basic HTTP request by selecting HTTP method as GET and entering request URL as https://api.yapily.com/institutions
- Go to Authorization tab and select Basic Auth from Type dropdown
- Enter the application's key and secret from the secret file you downloaded before (from Step 2) against Username and Password respectively to authenticate your requests to your application.
- Click Send to make your first API request to test your integration.
Using cURL,
- Execute the cURL command by directly applying the application's key and secret to test your integration (or)
  Copy
  
  Copied
```
curl -u key:secret 'https://api.yapily.com/institutions'
```
- Generate an authToken using the application's key and secret to authenticate your requests to your application . Then execute the cURL command using the authToken to test your integration.
  Copy
  
  Copied
```
curl -X GET 'https://api.yapily.com/institutions' -H 'Authorization: Basic {authToken}'
```

Congratulations! You have executed your first API call to retrieve all the institutions associated with your Yapily application.

6. Next Steps

Start using real banking data by submitting our Contact Form, or explore our Postman collection in the Yapily Console > My Applications > Your application > Tools section.