KlyroPay Developer Platform

Developer Documentation & Arc L1 API

Integrate programmatic USDC checkout links, server-side receipt verification, signed webhooks, and merchant settlement with automatic daily payouts.

Arc Network L1 RPC

Native USDC Gas Architecture

Arc is an EVM-compatible Layer-1 chain where USDC is the native gas asset. Transactions settle deterministically in sub-second time.

Network Name

Arc Network Testnet

RPC Endpoint

https://rpc.testnet.arc.network

Chain ID

5042002 (0x4cf212)

Gas Asset

USDC (Native L1 Gas)

Block Explorerhttps://testnet.arcscan.app

Test in Webapp Sandbox

Quickstart Example: Create Payment Link

// 1. Create a Payment Link via KlyroPay REST API
const response = await fetch('https://klyropay.com/api/links', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-wallet-address': '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',
  },
  body: JSON.stringify({
    amount: 100.00,
    title: 'Consulting Retainer & Audit',
    currency: 'USDC',
  }),
});

const data = await response.json();
console.log('Payment Link URL:', data.link.url);
// -> "https://klyropay.com/pay/consult-100"

Core API Endpoints

POST/api/pay/initiate

Initializes a payment intent for a hosted checkout link. Enforces idempotency via client-provided keys and verifies recipient validity.

Payload: { linkCode: "demo100", payerAddress: "0x...", idempotencyKey: "uuid" }

POST/api/pay/verify

Verifies onchain transaction confirmation on Arc L1. Updates internal state to PAID, records double-entry journal entries, and emits webhook events.

Payload: { linkCode: "demo100", txHash: "0x...", payerAddress: "0x..." }

GET/api/links

Retrieves all active, paid, and archived payment links for the authenticated merchant address.

GET/api/users/lookup?username=handle

Resolves human-readable KlyroPay usernames (e.g. @alice) to verified Arc EVM public addresses.

Merchant API settlement

Use a server-side sk_test_ or sk_live_ key. Payment creation requires an Idempotency-Key. Verify a completed payment and read its receipt before fulfilling an order.

POST /api/v1/transaction/initialize
GET  /api/v1/transaction/verify/{reference}
GET  /api/v1/receipts/{reference}

Webhook events:
payment.completed  payout.completed  payout.failed

Merchant funds are credited to the settlement ledger after Arc verification. Daily payouts require a verified wallet, enforce minimums and daily limits, and wait 24 hours before a changed wallet becomes active. Treasury signing is isolated behind an external signer; no private key is stored in this application.