/
v2026.1 Released

Build with Wyrr

Make your first API call in under 2 minutes. Collect payments, convert currencies, and disburse funds across 40+ countries with a single integration.

Quick Start

1

Create your account

Sign up at dashboard.wyrr.com to get access to your test environment. No credit card required.

2

Get your API keys

Navigate to Settings → API Keys in your dashboard. You will get a test key pair (public + secret). Keep your secret key safe — never expose it in client-side code.

.env
# Your test API keys (never share the secret key!)
WYRR_API_KEY=wyrr_test_pk_abc123def456...
WYRR_API_SECRET=wyrr_test_sk_xyz789ghi012...
3

Make your first API call

Create a payment collection to charge a customer. Here is a complete working example in your language of choice:

const Wyrr = require('@wyrr/node');

const client = new Wyrr({
  apiKey: process.env.WYRR_API_KEY,
  apiSecret: process.env.WYRR_API_SECRET,
  environment: 'test'  // 'live' for production
});

// Create a $50.00 payment collection
const collection = await client.collections.create({
  amount: 5000,        // amount in cents
  currency: 'USD',
  paymentMethod: 'card',
  description: 'Order #12345',
  metadata: {
    orderId: '12345',
    customer: 'test@example.com'
  }
}, {
  idempotencyKey: 'order-12345-attempt-1'
});

console.log(collection.id);           // col_a1b2c3d4
console.log(collection.status);       // "pending"
console.log(collection.client_secret); // use this client-side

Base URL

Production

https://api.wyrr.com

Test / Sandbox

https://api.test.wyrr.com