Make your first payment.

Try it first

Run a recovery-safe test payment#

You need Node 22 and a new folder for this sandbox exercise.

Install the pinned SDK and save the complete example as t0.mjs.
Run node t0.mjs and keep .playmos-demo-purchase.json.
Run it again and compare the payment ID.

Check your result The second run verifies the original purchase instead of creating a second payment.

Install the SDK, make a test payment and inspect a real receipt. No wallet is needed for the public sandbox IAP path.

1. Install the SDK#

InstallTerminal

npm install @playmos/sdk@0.3.38

Examples target SDK 0.3.38. For Node, use a runtime supported by the package’s engines; Node 22 is supported. The browser entry is @playmos/sdk. Webhook verification uses the server-only entry.

2. Create a payment#

Save the complete example as t0.mjs in your project. It saves a purchase key before calling pay(). The public sandbox key and settle: 'server' use the service’s Base Sepolia test signer.

Run the first paymentTerminal

node t0.mjs

The runner keeps .playmos-demo-purchase.json. After a payment ID exists, running it again verifies that same ID. Keep this file for recovery; intentionally use a new purchase file only for a new purchase.

Continue with the next guide →

t0.mjs · runnable Node exampleJavaScript

import { Playmos } from '@playmos/sdk';
import { randomUUID, createHash } from 'node:crypto';
import { readFile, writeFile } from 'node:fs/promises';
import { pathToFileURL } from 'node:url';
 
// A local demo purchase file holds no API secrets. Keep it for recovery.
export async function firstPayment(
  client = new Playmos({ apiKey: 'pk_test_playmos_sandbox', settle: 'server' }),
  purchaseFile = '.playmos-demo-purchase.json',
) {
  const mode = client.config.mock ? 'offline' : 'sandbox';
  const apiBaseUrl = new URL(client.config.apiBaseUrl || 'https://api.sandbox.playmos.io/v1').href.replace(/\/$/, '');
  if (!/^pk_test_/.test(client.config.apiKey) || client.config.network && client.config.network !== 'base-sepolia') {
    throw new Error('This exercise requires a publishable test key and Base Sepolia.');
  }
  if (!client.config.mock && !['https://api.test.playmos.io/v1', 'https://api.sandbox.playmos.io/v1'].includes(apiBaseUrl)) {
    throw new Error('This exercise requires a Playmos test API host.');
  }
  const connection = createHash('sha256').update(JSON.stringify([apiBaseUrl, client.config.apiKey])).digest('hex');
  let purchase;
  try {
    purchase = JSON.parse(await readFile(purchaseFile, 'utf8'));
    if (!purchase || typeof purchase.key !== 'string' || purchase.mode !== mode || purchase.connection !== connection) {
      throw new Error('Invalid purchase file or mismatched mode / API connection. Keep the original for recovery.');
    }
  } catch (error) {
    if (error.code !== 'ENOENT') throw error;
    purchase = { key: randomUUID(), mode, connection };
    await writeFile(purchaseFile, JSON.stringify(purchase), { flag: 'wx', mode: 0o600 });
  }
 
  if (!purchase.paymentId) {
    try {
      const payment = await client.pay({
        gameId: 'game_sandbox_iap', amount: '0.01',
        sku: 'extra-life', playerId: 'sandbox-player',
        idempotencyKey: purchase.key, settleTimeoutMs: 45_000,
      });
      purchase.paymentId = payment.id;
    } catch (error) {
      const id = error.detail?.paymentId;
      if (typeof id !== 'string') throw error;
      purchase.paymentId = id; // The service created it before the timeout.
    }
    await writeFile(purchaseFile, JSON.stringify(purchase), { mode: 0o600 });
  }
 
  // Rerunning with a saved ID verifies it; it does not create another purchase.
  const receipt = await client.verify(purchase.paymentId);
  return { mode, receipt };
}
 
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
  try {
    const result = await firstPayment();
    console.log(JSON.stringify(result, null, 2));
    if (result.receipt.status !== 'confirmed' || result.receipt.verifiedVia !== 'chain') {
      console.error('Not chain-confirmed. Keep the purchase file and run again to verify this ID.');
      process.exitCode = 1;
    }
    // Demo display only. Your studio backend verifies and grants once.
  } catch (error) {
    console.error(error.message);
    process.exitCode = 1;
  }
}

Make your first payment.

Run a recovery-safe test payment#

1. Install the SDK#

2. Create a payment#

3. Inspect the receipt#

4. Connect your backend#

If it did not work#