@arcora/sdk

Stripe-style checkout SDK for Arcora — stablecoin payments on Arc Network. Three functions, zero EVM dependencies, ~1.5 KB gzipped.

Install

npm install @arcora/sdk
# or
pnpm add @arcora/sdk

For React: npm install @arcora/react

Usage

import { Arcora } from "@arcora/sdk";

Arcora.init({ apiKey: "ak_live_...", environment: "testnet" });

const invoice = await Arcora.createInvoice({
  amountUsdc: 49.99,
  payInToken: "EURC",
  successUrl: "https://my-store.com/success",
});

Arcora.openCheckout(invoice);

React

import { CheckoutButton } from "@arcora/react";

<CheckoutButton
  apiKey="ak_live_..."
  environment="testnet"
  invoice={{
    amountUsdc: 49.99,
    payInToken: "EURC",
    successUrl: "https://my-store.com/success",
  }}
>
  Pay €49.99
</CheckoutButton>

Hook

import { useCheckout } from "@arcora/react";

const { checkout, loading, error } = useCheckout({ apiKey: "ak_live_..." });

<button onClick={() => checkout({ amountUsdc: 49.99, payInToken: "EURC", successUrl: "..." })}>
  {loading ? "Loading..." : "Pay €49.99"}
</button>

API

Arcora.init(options)

Arcora.createInvoice(params) → Promise<{ invoiceId, url }>

Throws ArcoraError on failure with discriminated code:

• INVALID_API_KEY — 401 from server
• SERVER_ERROR — 5xx (includes retryAfter if Retry-After header set)
• NETWORK — fetch failed
• INVALID_URL — non-http(s) successUrl/cancelUrl
• TIMEOUT, UNKNOWN

Arcora.openCheckout(invoice)

Redirects browser to invoice.url. Throws if not in a browser environment.

Error handling

import { Arcora, ArcoraError } from "@arcora/sdk";

try {
  await Arcora.createInvoice({ ... });
} catch (e) {
  if (e instanceof ArcoraError) {
    if (e.code === "INVALID_API_KEY") /* ... */;
    if (e.code === "SERVER_ERROR" && e.retryAfter) /* ... */;
  }
}

Live demo

arc-fx-gateway.vercel.app — pay in USDC or EURC on Arc testnet. Get test EURC from faucet.circle.com (select Arc Testnet).

Bundle

Zero runtime dependencies. Tree-shake-safe (sideEffects: false).

Source

github.com/Kubudak90/arc-fx-gateway — packages/sdk/

License

MIT.