Get started

At PPRO, we’re on a mission to connect local economies to global opportunities. Our API makes it simple: with a single integration, you can offer a wide network of local payment methods directly within your apps and platforms.

Follow these steps to get started:

1. Get a sandbox account
   Before you can start integrating with PPRO, you need a sandbox account. A safe, test environment where you can explore our API without affecting real payments.

   • New Customers: Contact us to get your sandbox account.
   • Existing Customers: Reach out to your account manager to request sandbox access.

   You'll be provided with API credentials to authenticate your requests and admin access to the PPRO Dashboard..

2. Add team members
   Log in to the PPRO Dashboard and create additional user accounts for your team. Assign appropriate roles and permissions so everyone involved in your integration can access the sandbox, monitor API activity, and test collaboratively.

1. Configure API authentication
   Before you start making requests, take a moment to understand how authentication works in the PPRO API. Every request you send must include your API key, which identifies and authorizes your application. Without it, the API will reject your requests.
   Most endpoints, particularly those specific for payment service providers (PSPs), require additional headers such as Merchant-Id or Psp-Id. These headers allow the API to correctly associate your requests with the right entity within the PPRO platform.

2. Set up webhooks
   Webhooks are a critical part of your PPRO integration. They allow your system to receive real-time notifications whenever important business events occur.

3. Build against reusable payment flows
   The API is designed around a set of reusable payment flows that define how payments are authenticated and completed across different payment methods. These flows standardize how your integration interacts with the API, allowing you to support new payment methods without rewriting your logic each time.

   When building your integration, focus on implementing these core flows rather than adding conditional logic for each individual payment method. Avoid using if statements or payment method-specific handling, the API abstracts those differences for you. This approach keeps your integration cleaner, easier to maintain, and more adaptable as you expand to new markets and payment types.

4. Make your first API call
   Use the developer resources available to help you explore the API quickly, test endpoints, and understand how payment flows behave.

   All payment methods are available in the sandbox environment, allowing you to experiment freely. You can also use the mock authenticator to simulate different payment flows and outcomes. This lets you see how your application should respond to each scenario before moving to the live environment.

5. Complete your sandbox integration
   Once you’ve implemented and tested your payment flows in the sandbox, take time to complete your integration and verify all key components. Confirm that your API authentication, webhook handling, and reusable payment flows are working as expected. Make sure your application correctly handles different payment outcomes and implements proper error handling.

   If you’re a payment service provider (PSP), you can also start exploring how to board merchants to PPRO. In addition, review the disputes and reporting features to understand how to manage payment lifecycles, reconcile payments, and handle operational scenarios.

1. Sandbox certification
   Once you’ve thoroughly tested your integration in the sandbox and are confident in its functionality, you can begin preparing for the live environment. Before going live, you’ll be asked to complete sandbox certification, which verifies that your integration meets PPRO’s requirements and performs as expected.

2. Update endpoints and configurations accordingly

   🏁

   To start processing real payments, your account must be activated. Use your live credentials and the api.eu.ppro.com host instead of the sandbox environment.

   Live API: https://api.eu.ppro.com

   Sandbox API: https://api.sandbox.eu.ppro.com