Getting Started with Wise API

This guide provides the essential information you need to begin integrating with the Wise API. Take a look at each section to make sure you know how to get up and running quickly.

Once our partnership begins, we’ll send you API access credentials for the sandbox environment, consisting of a Client ID and a Client Secret. These credentials are required for making authenticated calls to the Wise API.

The Client Secret is a highly sensitive piece of data. It can be used to impersonate your institution on the Wise Platform API. It must be handled and stored with the utmost care, seen by as few people as possible, and stored in a secure secret storage solution, preferably away from any other Wise data.

Wise provides different environments for development, testing, and production. Understanding these environments is crucial for a smooth integration process.

• Sandbox: This is your initial playground. Use the sandbox environment for development and testing your integration without affecting live data or customer funds.
• Production: Once your integration is thoroughly tested and approved, you'll move to the production environment for live operations.

Learn more about Environments

Security is critical when working with financial APIs. Beyond protecting your Client Secret, consider these fundamental best practices:

• Mutual TLS (mTLS): Implement mTLS for enhanced security, ensuring both client and server authenticate each other. This provides a strong layer of trust for your API communications.
• Secure Credential Storage: Always store your API credentials, especially the Client Secret, in a secure, encrypted manner. Avoid hardcoding them directly into your application code.

Now you have the foundational knowledge to begin your integration. Here's what to do next:

• Dive straight into the specific integration guide for your use case. These guides provide step-by-step instructions and code examples for our most popular integration models.
• Explore the API Reference: Look closer at the Wise Platform API with our comprehensive API Reference.
• Webhooks: Understand how to use webhooks to receive real-time notifications about events, which is crucial for handling asynchronous processes.
• Error Handling: Design error handling into your application to manage API responses and ensure a smooth user experience.
• Versioning: Familiarize yourself with the API versioning strategy to ensure your integration remains compatible with future updates.