Payeny Payment Orchestration Platform

The single, unified payments engine powering EntryHub, JumpHQ, EquipLink, Audovo, and Elept.

Quickstart in 3 Steps

Integrate Payeny into your SaaS in less than 5 minutes.

npm install payeny

composer require nexovex/payeny-php

const Payeny = require('payeny');
const payeny = new Payeny(process.env.PAYENY_API_KEY);

// 1. Create customer
const customer = await payeny.customers.create({
  email: 'client@example.com',
  name: 'Acme Corp'
});

// 2. Create payment intent
const payment = await payeny.payments.create({
  amount: 4900, // $49.00 USD in cents
  currency: 'usd',
  customer_id: customer.data.id,
  description: 'Monthly SaaS License'
}, {
  idempotencyKey: 'idemp_unique_order_88'
});

console.log('Client Secret:', payment.data.client_secret);

<?php
use Payeny\PayenyClient;

$payeny = new PayenyClient($_ENV['PAYENY_API_KEY']);

$customer = $payeny->customers->create([
    'email' => 'client@example.com',
    'name' => 'Acme Corp'
]);

$payment = $payeny->payments->create([
    'amount' => 4900,
    'currency' => 'usd',
    'customer_id' => $customer['data']['id'],
    'description' => 'Monthly SaaS License'
], [
    'idempotency_key' => 'idemp_unique_order_88'
]);

echo "Client Secret: " . $payment['data']['client_secret'];

curl -X POST https://payeny.com/api/v1/payments \
  -H "Authorization: Bearer payeny_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: idemp_unique_order_88" \
  -d '{
    "amount": 4900,
    "currency": "usd",
    "customer_id": "cus_b902af4fdaa5867265eb",
    "description": "Monthly SaaS License"
  }'

Authentication & Security

Authenticate requests by passing your API key as a Bearer token in the Authorization header.

Normalized Domain Identifiers

Payeny never exposes raw third-party IDs as primary resource identifiers. All domain objects use deterministic prefixes.

Official Client SDKs

Official libraries with built-in TypeScript typings, automatic retry handling, and signature verification.

npm install payeny

composer require nexovex/payeny-php

Platform Profiles & Routing

Payeny routes transactions dynamically through a strict 5-tier routing hierarchy.

Stripe Connect & Connected Merchants

Onboard marketplace partners, service providers, and vendors with automated Express onboarding.

const link = await payeny.merchants.createOnboardingLink('mer_3625e5181f713fac', {
  return_url: 'https://mysaas.com/connect/return',
  refresh_url: 'https://mysaas.com/connect/refresh'
});

// Redirect merchant to link.data.url
console.log('Onboard URL:', link.data.url);

Application Fee Engine & Monetization

Monetize every transaction with automatic platform take rates, fixed fees, and minimum/maximum caps.

Immutable Double-Entry Ledger

Complete GAAP-compliant accounting audit trail ensuring debits and credits always balance.

Hosted Checkout & Embed Modal

Collect payments effortlessly through Payeny's warm ledger hosted checkout page or embed directly in your SaaS.

<script src="https://payeny.com/assets/js/payeny.js"></script>
<script>
  const payeny = new Payeny();

  // Open modal for a session generated by your backend
  payeny.openModal('cs_6f3d2267849c131765587b3e', {
    onSuccess: function(data) {
      console.log('Payment successful!', data);
      window.location.href = '/billing/success';
    },
    onCancel: function() {
      console.log('Checkout closed by user');
    }
  });
</script>

Dual Webhooks Architecture

Payeny ingests Stripe events from multiple platforms, updates balances, and dispatches signed events to your SaaS subscribers.

Webhook Signature Verification

Validate incoming webhooks using HMAC-SHA256 with replay prevention tolerance.

const Payeny = require('payeny');

app.post('/webhooks/payeny', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-payeny-signature'];
  try {
    const event = Payeny.webhooks.constructEvent(req.body, sig, process.env.PAYENY_WEBHOOK_SECRET);
    console.log('Verified event:', event.type, event.data.object.id);
    res.json({ received: true });
  } catch (err) {
    res.status(400).send(`Webhook Error: ${err.message}`);
  }
});

<?php
use Payeny\Webhook;

$payload = file_get_contents('php://input');
$signatureHeader = $_SERVER['HTTP_X_PAYENY_SIGNATURE'] ?? '';

try {
    $event = Webhook::constructEvent($payload, $signatureHeader, $_ENV['PAYENY_WEBHOOK_SECRET']);
    // Process verified event
    http_response_code(200);
    echo json_encode(['received' => true]);
} catch (\Exception $e) {
    http_response_code(400);
    echo "Webhook error: " . $e->getMessage();
}

Checks database latency, operational status, default platform profile health, and system capabilities.

{
  "data": {
    "status": "operational",
    "version": "2.0.0",
    "api_version": "2026-09-01",
    "system": {
      "database": { "status": "healthy", "latency_ms": 0 },
      "default_profile": {
        "id": "plt_default",
        "name": "Payeny Default",
        "provider": "stripe",
        "status": "active"
      }
    }
  },
  "request_id": "req_6d380f214e60142c",
  "livemode": false
}

Creates a new customer in Payeny and provisions the corresponding customer record in the active Stripe profile.

Create a direct or destination charge payment intent. Supports automatic capture or manual authorization holds.

Generate a hosted checkout session URL or an embed token for drop-in modal checkout on your SaaS.

Register connected merchants and manage their Stripe Connect lifecycle.

Disburse platform balances or marketplace partner funds to connected accounts.

Issue full or partial refunds for settled payments. Automatically adjusts double-entry ledger entries.

Query monetization fee rules or preview application fee deductions before initiating a charge.

curl -X POST https://payeny.com/api/v1/fee-rules/preview \
  -H "Authorization: Bearer payeny_test_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 10000, "currency": "usd"}'

Retrieve verified double-entry balances across all 5 standard ledger account classes.

{
  "data": {
    "assets": { "currency": "USD", "balance_cents": 490000 },
    "liabilities": { "currency": "USD", "balance_cents": 441000 },
    "revenue": { "currency": "USD", "balance_cents": 49000 },
    "balanced": true
  },
  "request_id": "req_8819bc42a0"
}

Interactive API Sandbox

Execute a real HTTP request against the live Payeny cluster right now.

{
  "click_execute_above": true
}