Create an Invoice

1
import { Gwop } from "@gwop/sdk";
2
3
const gwop = new Gwop({
4
  merchantApiKey: process.env.GWOP_MERCHANT_API_KEY,
5
});
6
7
const { result: invoice } = await gwop.invoices.create({
8
  idempotencyKey: crypto.randomUUID(),
9
  body: {
10
    amountUsdc: 5_000_000, // $5.00 USDC (6 decimals)
11
    description: "Starter plan — 300 credits",
12
    metadata: { planId: "starter" },
13
  },
14
});
15
16
console.log(invoice.publicInvoiceId); // inv_7dbeeaad...
17
console.log(invoice.status);          // "OPEN"
18
console.log(invoice.agentProtocol);   // Machine-readable payment instructions

1
const key = crypto.randomUUID(); // generate once, retry with same key
2
3
// First call creates the invoice
4
const { result: first } = await gwop.invoices.create({
5
  idempotencyKey: key,
6
  body: { amountUsdc: 5_000_000 },
7
});
8
9
// Retry with same key returns the same invoice
10
const { result: second } = await gwop.invoices.create({
11
  idempotencyKey: key,
12
  body: { amountUsdc: 5_000_000 },
13
});
14
15
first.id === second.id; // true

1
const { result } = await gwop.invoices.create({
2
  idempotencyKey: crypto.randomUUID(),
3
  body: {
4
    amountUsdc: 1_000_000,
5
    expiresInSeconds: 60, // 1 minute
6
  },
7
});
8
9
// expiresAt will be ~60 seconds after createdAt

1
const { result } = await gwop.invoices.create({
2
  idempotencyKey: crypto.randomUUID(),
3
  body: {
4
    amountUsdc: 5_000_000,
5
    description: "Starter plan",
6
    metadata: { planName: "Starter", credits: 300 },
7
    metadataPublic: true, // agent can see this
8
  },
9
});