SANDBOX MODE SANDBOX — test mode, no real charges
Payeny
INTEGRATION WORKBOOK

Connect client-to-cash
into any application.

Build real-time provisioning pipelines. When a proposal is signed or invoice paid, dispatch authenticated webhooks to unlock access, create repositories, and alert your team.

// Verify Payeny-Signature: t=<unix>,v1=<hmac>
const crypto = require('crypto');

app.post('/payeny-webhook', (req, res) => {
  const sigHeader = req.headers['payeny-signature'] || '';
  const entries = sigHeader
    .split(',')
    .map(p => p.trim().split('='));
  const parts = Object.fromEntries(entries);
  const expected = crypto
    .createHmac('sha256', process.env.PAYENY_WEBHOOK_SECRET)
    .update(`${parts.t}.${req.rawBody}`)
    .digest('hex');

  if (parts.v1 !== expected) {
    return res.status(400).send('Bad Signature');
  }
  const { type, data } = JSON.parse(req.rawBody);
  if (type === 'checkout.completed' || type === 'invoice.paid') {
    provisionClientWorkspace(data.object.customer_id);
  }
  res.json({ received: true });
});
END-TO-END EVENT FLOW

What happens when a client checks out.
Deterministic, authenticated webhooks.

Every milestone in the client-to-cash pipeline emits a cryptographically signed HMAC event so your systems react instantly.

01 · CLIENT ACTION

Contract Signed

Client completes digital signature on their branded space with legal timestamp verification.

ESIGN compliant
02 · CORE ENGINE

Audit Log Created

Payeny hashes document snapshot, updates ledger status, and issues deposit invoice automatically.

SHA-256 seal
03 · OUTBOUND HOOK

Webhook Fired

Dispatches signed contract.executed JSON event with millisecond latency.

HMAC-SHA256 signature
04 · YOUR STACK

Client Provisioned

Internal CRM updated, Slack channel notified, and deliverable access unlocked immediately.

Instant unlock
ARCHITECTURE & RELIABILITY

Built for resilient production systems.
Zero guesswork, total control.

Designed for mission-critical payment workflows with cryptographic verification, automatic retries, and comprehensive audit logs.

Security

HMAC-SHA256 Signatures

Every outbound webhook payload is signed with your secret key. Verify timestamps and signatures to prevent replay attacks and header spoofing.

  • Standardized Payeny-Signature
  • Timestamp tolerance window
  • Secret key rotation tools
Resilience

Automated Retries

If your server returns anything other than an HTTP 2xx status code, Payeny automatically retries event delivery with exponential backoff over a 72-hour window.

  • Exponential backoff schedule
  • Dead-letter queue inspection
  • Manual retry trigger from dashboard
Developer Experience

Sandbox & Test Mode

Test your webhook consumers locally using test-mode API keys. Dispatch mock payment, signature, and booking events directly from the dashboard.

  • Dedicated test API keys
  • One-click mock event dispatch
  • Full payload & response logs

Explore the full API documentation.
Start building today.

Review endpoint specifications, authentication schemas, and interactive code samples.