Get 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.get({
8
  id: "inv_21bd059c2ad849efb2112437f5284e1e",
9
});
10
11
console.log(invoice.status);                    // "OPEN"
12
console.log(invoice.amount.display);            // "1.025 USDC"
13
console.log(invoice.paymentMethods);            // [{id: "x402-base", ...}, ...]
14
console.log(invoice.merchant.name);             // "agentrouter"
15
console.log(invoice.statusCheck.url);           // Polling URL

1
// Agent-side polling pattern
2
const checkUrl = invoice.statusCheck.url;
3
const paidValue = invoice.statusCheck.paidValue; // "PAID"
4
5
const poll = async () => {
6
  const res = await fetch(checkUrl);
7
  const data = await res.json();
8
  return data[invoice.statusCheck.field] === paidValue;
9
};

1
const { result: paid } = await gwop.invoices.get({ id: "inv_..." });
2
3
paid.status;              // "PAID"
4
paid.paidAt;              // Date — settlement timestamp
5
paid.paidAmount;          // 5125000 — amount settled
6
paid.paymentChain;        // "base" or "solana"
7
paid.paymentChainCaip2;   // "eip155:8453"
8
paid.paidTxHash;          // "0xcd2688e1..." — on-chain tx hash
9
paid.txUrl;               // "https://basescan.org/tx/0xcd2688e1..."
10
paid.paymentMethods;      // undefined — no longer payable

1
import * as errors from "@gwop/sdk/models/errors";
2
3
try {
4
  await gwop.invoices.get({ id: "inv_doesnotexist" });
5
} catch (err) {
6
  if (err instanceof errors.ErrorResponse) {
7
    err.data$.error.code;    // "INVOICE_NOT_FOUND"
8
    err.data$.error.message; // "Invoice not found"
9
    err.statusCode;          // 404
10
  }
11
}