Getting Started Guide

Environments

These are the URLs for the endpoints to get access to environments.

Sandbox:
https://tpp-sandbox.papaya.eu/banklink/{service}

Production:
https://tpp.papaya.eu/banklink/{service}

Sandbox is isolated from the production environment, so operations that you perform in the Financial Organisation sandbox don’t affect the production environment. The production version of the API provides access to the real customer data, i.e. you will be able to initiate real payments with PSU permission. Another API KEY will be generated for using in your application in production environment.

Registration in Portal

To use Developer Portal, you need to REGISTER for an account. Papaya Ltd collects certain in formation for your Developer Portal Profile in order to provide access to the portal and its services. In your “profile settings”, you can change your profile information, password and add eIDAS certificate public key. When you have an account, you will be able to create applications and test the integration of our APIs. Apps provide an API Key that is used to verify the subscriptions of your app.

Read and accept the Terms and Conditions and the Data Privacy Notice.

After submitting your first registration form you will receive an e-mail with an activation link.

Click on the link “ACTIVATE YOUR ACCOUNT” in the received e-mail. This action will complete your registration process, activate your account and transfer you to the “Sign In” page.

Note:
What would you fully start working with Financial Institution API in production, make sure you have the NCA license and eIDAS certificates QSEAL and QWAC. Each country has their own guidelines on obtaining a license, please contact with your local NCA.

Sign In

After successful registration and activation TPP can sign in to the Financial Institution portal.

Sign In page:

Type in a username or e-mail and password and click SIGN IN button. By signing in TPP gets access to their unique API key, documentation, API explorer and code examples.

Create an Application

The next step is to configure your application (My Apps). Apps keep track of your credentials for using our APIs. For each app you will receive an API key.

Subscribe to an API

In order to test APIs in the Portal Sandbox your application must be subscribed to an API. You can subscribe to APIs from the available API Sets when creating an application directly. You can view and manage your subscription including API versions in each application.

API Catalog

Without registration you can see only API Catalog where we provide list of supported API’s and short description. If you need more information about API’s you need to register in to this portal.

API Reference

The Documentation enables you to quickly understand and see raw API calls and the data returned by these calls. In order to read and use it, you will need registration credentials.

API Key

To start using Papaya’s Open APIs, TPP must obtain their unique API key. Copy your unique API key from My Apps section in the Sandbox or production part. (/console/applications).
API key must be included in every API call as a HTTP header with the name: “X-Api-Key”. For example: {“X-API-Key”: “bf40bc62-5327-4966-bcb5eb5468e92d57”}

note:
API request without a valid API Key will lead to “Error 404” message.

note:
API Key is specific to TPP and its applications. TPP must not disclose their API Key to any other person. Test using Postman tool

Postman is great tool to test and integrate APIs. If you don’t have Postman, download it here. See Postman’s documentation and tutorials for any questions about using Postman.