Getting Started

Signup to first sandbox payment. Under 10 minutes.

Five steps from sandbox to live. Each one builds on the last. Mark them done as you go, progress saves automatically.

~11 min total

|0/5 complete

0 of 5 complete

Create your account

~30 sec

Create Free Account

Node.js

1// After signup you'll land on the dashboard.
2// Your sandbox is ready, no configuration needed.
3//
4// What you have now:
5// ✓ Merchant account in sandbox mode
6// ✓ Webhook endpoint auto-configured
7// ✓ 9 chains available (Solana, Ethereum, Base, etc.)
8// ✓ USDC settlement by default

Get your API key

~1 min

Generate a sandbox API key from the dashboard. Test keys start with sk_test_ and never touch real funds.

Open Dashboard

Node.js

1// 1. Go to Dashboard → Settings → API Keys
2// 2. Click "Create API Key"
3// 3. Copy the key (starts with sk_test_)
4
5// Set it as an environment variable:
6export PAYVRA_TEST_KEY=sk_test_abc123...
7
8// Verify it works:
9import { Payvra } from "payvra";
10
11const payvra = new Payvra(process.env.PAYVRA_TEST_KEY!);
12const keys = await payvra.apiKeys.list();
13console.log("Authenticated:", keys.length, "key(s) found");

Make your first API call

~2 min

Create a payment with 14 lines of code. You'll get back a checkout URL where customers pay.

Node.js

1import { Payvra } from "payvra";
2
3const payvra = new Payvra(process.env.PAYVRA_TEST_KEY!);
4
5const payment = await payvra.payments.create({
6  amount: "49.99",
7  currency: "USDC",
8  chain: "solana",
9  metadata: { orderId: "order_123" },
10});
11
12console.log("Payment ID:", payment.id);
13console.log("Status:", payment.status);
14console.log("Checkout:", payment.checkoutUrl);

Complete your first sandbox payment

~3 min

Open the checkout URL from step 3 and let sandbox simulate a paying customer. The full lifecycle, detection, confirmation, settlement, runs end to end.

Open Test Checkout

Node.js

1// Open the checkoutUrl from step 3 in your browser.
2// Sandbox auto-completes after a few seconds.
3//
4// Then poll the payment until it confirms:
5import { Payvra } from "payvra";
6
7const payvra = new Payvra(process.env.PAYVRA_TEST_KEY!);
8
9const paymentId = "pay_..."; // from step 3
10let payment = await payvra.payments.retrieve(paymentId);
11
12while (payment.status !== "completed") {
13  await new Promise((r) => setTimeout(r, 2000));
14  payment = await payvra.payments.retrieve(paymentId);
15  console.log("Status:", payment.status);
16}
17
18console.log("Paid:", payment.amount, payment.currency);

Switch to live and accept your first real payment

~4 min

Toggle to live mode in the dashboard, generate a sk_live_ key, swap it into your code. Same SDK, same API, only the key prefix changes.

Switch to Live Mode

Node.js

1// 1. In the dashboard, toggle the top-right switch from Test → Live
2// 2. Settings → API Keys → Create API Key (now produces sk_live_...)
3// 3. Set it alongside your test key:
4//    export PAYVRA_LIVE_KEY=sk_live_...
5
6import { Payvra } from "payvra";
7
8// Same SDK. Different key.
9const payvra = new Payvra(process.env.PAYVRA_LIVE_KEY!);
10
11const payment = await payvra.payments.create({
12  amount: "9.99",
13  currency: "USDC",
14  chain: "base", // cheapest gas for small amounts
15  metadata: { orderId: "order_real_001" },
16});
17
18console.log("Live payment:", payment.id);
19console.log("Pay here:", payment.checkoutUrl);

Want the deeper tutorial covering webhook signing verification, settlement controls, and production hardening?

Quickstart Tutorial

1// After signup you'll land on the dashboard. 2// Your sandbox is ready, no configuration needed. 3// 4// What you have now: 5// ✓ Merchant account in sandbox mode 6// ✓ Webhook endpoint auto-configured 7// ✓ 9 chains available (Solana, Ethereum, Base, etc.) 8// ✓ USDC settlement by default

1// 1. Go to Dashboard → Settings → API Keys 2// 2. Click "Create API Key" 3// 3. Copy the key (starts with sk_test_) 4 5// Set it as an environment variable: 6export PAYVRA_TEST_KEY=sk_test_abc123... 7 8// Verify it works: 9import { Payvra } from "payvra"; 10 11const payvra = new Payvra(process.env.PAYVRA_TEST_KEY!); 12const keys = await payvra.apiKeys.list(); 13console.log("Authenticated:", keys.length, "key(s) found");

1import { Payvra } from "payvra"; 2 3const payvra = new Payvra(process.env.PAYVRA_TEST_KEY!); 4 5const payment = await payvra.payments.create({ 6 amount: "49.99", 7 currency: "USDC", 8 chain: "solana", 9 metadata: { orderId: "order_123" }, 10}); 11 12console.log("Payment ID:", payment.id); 13console.log("Status:", payment.status); 14console.log("Checkout:", payment.checkoutUrl);

1// Open the checkoutUrl from step 3 in your browser. 2// Sandbox auto-completes after a few seconds. 3// 4// Then poll the payment until it confirms: 5import { Payvra } from "payvra"; 6 7const payvra = new Payvra(process.env.PAYVRA_TEST_KEY!); 8 9const paymentId = "pay_..."; // from step 3 10let payment = await payvra.payments.retrieve(paymentId); 11 12while (payment.status !== "completed") { 13 await new Promise((r) => setTimeout(r, 2000)); 14 payment = await payvra.payments.retrieve(paymentId); 15 console.log("Status:", payment.status); 16} 17 18console.log("Paid:", payment.amount, payment.currency);

1// 1. In the dashboard, toggle the top-right switch from Test → Live 2// 2. Settings → API Keys → Create API Key (now produces sk_live_...) 3// 3. Set it alongside your test key: 4// export PAYVRA_LIVE_KEY=sk_live_... 5 6import { Payvra } from "payvra"; 7 8// Same SDK. Different key. 9const payvra = new Payvra(process.env.PAYVRA_LIVE_KEY!); 10 11const payment = await payvra.payments.create({ 12 amount: "9.99", 13 currency: "USDC", 14 chain: "base", // cheapest gas for small amounts 15 metadata: { orderId: "order_real_001" }, 16}); 17 18console.log("Live payment:", payment.id); 19console.log("Pay here:", payment.checkoutUrl);