Integration Guide

This section is intended for multi-tenant workflow applications, Integration Platform as a Service (iPaaS) providers, MCP servers, and SaaS platforms who need to integrate Shuttle Payment Links on behalf of multiple merchants.

Important: To achieve Shuttle certification, integrators must follow our requirements exactly as specified (unless otherwise agreed with Shuttle). Deviation from prescribed implementations, field names, or integration patterns will prevent certification approval.

What You'll Learn

This guide covers the complete integration process for multi-tenant platforms:

Authentication - How to implement OAuth 2.0 for multiple merchants with sandbox and live environment support
Actions / Events - Prescriptive implementation requirements for Shuttle Payment Links API integration. This section defines our exact expectations for field names, field ordering, integration completeness, and additional undocumented requirements that must be met for Shuttle to certify your integration.
Webhooks - How to attach and detach webhooks to receive real-time notifications for payment link events across your connected merchant instances

Certification Requirements

To achieve Shuttle certification for your multi-tenant integration, you must:

Follow exact implementation specifications outlined in the API Endpoints section
Use prescribed field names and ordering as defined in our requirements
Implement complete integration coverage for all required Payment Links functionality
Meet additional undocumented requirements that will be provided during the certification process

Note: Live environment Client ID and Client Secret will only be provided upon successful certification completion.

Prerequisites

Before starting this integration:

Your platform supports OAuth 2.0 client flows
You can securely store and manage credentials for multiple merchants
You have the ability to prompt users for environment selection (sandbox vs live)
Contact Shuttle support to obtain OAuth credentials for both environments