Integrations

Overview

Protuno supports seamless integrations with payment gateways, accounting software, e-commerce platforms, and custom webhooks. You configure these connections through the Protuno dashboard at https://dashboard.example.com/integrations. This enables automated data sync, real-time payments, and custom event handling.

Payment Gateway Setup

Set up payment processors like Stripe or PayPal to accept payments directly in Protuno.

const stripe = require('stripe')('sk_test_YOUR_STRIPE_SECRET');
const paymentIntent = await stripe.paymentIntents.create({
  amount: 2000,
  currency: 'usd',
  metadata: { protuno_order_id: 'order_123' }
});

const paypal = require('@paypal/checkout-server-sdk');
const environment = new paypal.core.SandboxEnvironment(
  'YOUR_CLIENT_ID', 'YOUR_CLIENT_SECRET'
);
const client = new paypal.core.PayPalHttpClient(environment);

Accounting Software Sync

Connect Protuno to QuickBooks or Xero for automatic invoice and payment syncing.

const QuickBooks = require('node-quickbooks');
const qbo = new QuickBooks(
  'clientId',
  'clientSecret',
  'accessToken',
  false,
  false,
  'realmId',
  false,
  false,
  'refreshToken'
);
await qbo.createInvoice(invoiceData);

const XeroClient = require('xero-node');
const xero = new XeroClient({
  consumerKey: 'YOUR_CONSUMER_KEY',
  consumerSecret: 'YOUR_CONSUMER_SECRET',
  privateKey: 'YOUR_PRIVATE_KEY'
});
await xero.accounting.api.invoices.postInvoices({ Invoices: [invoice] });

E-commerce Platform Links

Link Protuno with popular e-commerce tools for order fulfillment.

Custom Webhook Configuration

Set up webhooks to receive Protuno events like order.created or payment.failed.

// Dashboard: POST https://dashboard.example.com/webhooks
{
  "url": "https://your-webhook-url.com/webhook",
  "events": ["order.created", "payment.failed"],
  "secret": "whsec_YOUR_WEBHOOK_SECRET"
}

Verify incoming payloads:

const crypto = require('crypto');
const sig = req.headers['protuno-signature'];
const hmac = crypto.createHmac('sha256', 'YOUR_WEBHOOK_SECRET');
hmac.update(req.body);
const computedSig = 'protuno-signature=' + hmac.digest('hex');
if (sig !== computedSig) {
  throw new Error('Invalid signature');
}

import hmac
import hashlib
payload = request.data
signature = 'protuno-signature=' + hmac.new(
  b'YOUR_WEBHOOK_SECRET',
  payload,
  hashlib.sha256
).hexdigest()
if request.headers.get('protuno-signature') != signature:
    raise ValueError('Invalid signature')

Partner Ecosystem

Track integration status across partners.