Paddle

Vayu integrates with Paddle to handle invoice payments, payment status updates, and customer billing workflows. Paddle can function as a customer's primary payment provider, enabling automatic invoice synchronization and real-time payment status updates from Paddle to Vayu.

The integration supports customers who are already using Paddle as well as customers who are new to Paddle, with onboarding handled either directly in Paddle or, in future iterations, through Vayu-assisted flows. It includes a payment link in the invoice itself, as well as an auto-collect feature you can toggle.

How the Paddle integration works

Once Paddle is connected for a customer, Vayu remains the source of truth for customers, contracts, and invoicing. Paddle is used for payment collection and payment status updates.

Invoices are generated in Vayu and can be synced to Paddle automatically or manually, depending on configuration. Auto-collection can also be enabled.

To set Paddle as the payment provider, open the customer profile, select Settings, scroll to Configurations, and choose Paddle as the primary payment provider. To enable auto-collection, turn on Automatically charge payment.

Invoice synchronization flow

When an invoice is approved in Vayu, one of two sync paths applies:

1. Automatic sync sends approved invoices from Vayu to Paddle automatically.
2. Manual sync lets users trigger invoice sync if auto-sync is disabled.

This sync ensures that invoice details created in Vayu are reflected in Paddle.

From Vayu invoice to Paddle invoice

Once synced, each invoice in Vayu includes a link to the corresponding Paddle invoice, making it easier for finance teams to move from billing in Vayu to payment processing in Paddle.

Payment methods and customer experience

Paddle supports multiple payment methods, including credit and debit cards, bank transfers, digital wallets, and other local payment methods.

From the customer's perspective, a synced invoice can include a Pay Online option or Paddle payment link that directs them to Paddle to complete payment. Auto-collection can also be enabled by turning on Automatically charge payment.

Payment status updates back to Vayu

After a payment attempt, Paddle updates the payment intent status as successful or failed. Vayu retrieves this status and updates the invoice accordingly.

Successful payments automatically update the invoice status to Paid in Vayu. Failed payments surface as part of Vayu's outstanding balances and AR workflows. This ensures billing, finance, and operations teams always see the current payment state without switching systems.

Future iterations may allow parts of this onboarding to be initiated or guided directly from Vayu.

Configuring the Paddle integration

Go to Paddle and get an API key for your Paddle account.

To get your Paddle API key, go to Paddle > Developer Tools > Authentication. Click the API keys tab, then click + New API key. Enter the required details, including the name, description, permissions, and expiration date, then click Save.

Back in Vayu, go to Integrations and open the Paddle panel. Click Manage.

Find the Paddle integration card under More integrations to connect, then click Connect. In the setup panel, enter the Paddle API key from your Paddle account. Select the Paddle environment that you want from the dropdown, either Production or Sandbox, then click Connect to Paddle.