Web3Settle
Get Started
Open source · audit everything

Build with Web3Settle.

Open-source tools, a comprehensive REST API, and detailed documentation to integrate non-custodial payments in minutes.

01/ Capabilities

Everything you need to ship today.

A focused toolkit: SDK, API keys, spec, demo, and signed webhooks. Nothing you don't need, everything you do.

Open-source SDK

Custom payment widget integration

Storefront-scoped JWT API keys

Programmatic B2B access

OpenAPI specification

Automated client generation

Demo application

Gaming merchant multi-chain demo

HMAC-SHA256 webhooks

Test endpoint for validation

Versioned releases

Semver-tagged releases of the SDK and server components. Pin a version, upgrade on your timeline.

02/ SDK

Drop-in checkout.

Our consumer-facing SDK is a React component. TypeScript-first, MIT-licensed (merchant-sdk only — see merchant-sdk/LICENSE), and designed to work across all five networks out of the box.

Open-source payment SDK

Handles wallet connection, network switching, transaction signing, and confirmation tracking. Style it with your own tokens, self-host it, or use our hosted widget.

quick-integration.tsx
import { Web3SettleProvider, Web3SettlePayButton } from '@web3settle/merchant-sdk'

<Web3SettleProvider
  apiUrl="https://payments.example.com"
  storefrontId="your-storefront-id"
>
  <Web3SettlePayButton
    amount={29.99}
    currency="USDT"
    onSuccess={(tx) => console.log('Payment confirmed:', tx.txHash)}
    onError={(err) => console.error('Payment failed:', err)}
  />
</Web3SettleProvider>
03/ REST API

Full programmatic control.

Deploy contracts, read deposits, configure webhooks, pull analytics. JWT-authenticated, scoped per storefront, IP-allowlisted if you want.

Endpoints
POST/api/contracts/deployDeploy a new merchant contract
GET/api/contracts/{id}/depositsList deposits for a contract
POST/api/webhooks/configureSet up webhook notifications
GET/api/analytics/summaryTransaction analytics
curl
curl -X GET https://payments.example.com/api/v1/contracts/deposits \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json"
04/ Self-host

Your infrastructure, your rules.

The full source tree is delivered to licensees. Build, deploy, and operate on your own infrastructure — strict data residency, bespoke compliance, full control.

Source-included delivery

Licensees receive the complete source tree (gateway-core-backend, both portals, merchant-sdk, smart contracts, gateway-infra Compose / Kustomize manifests). Pre-built container images are not shipped today; you build from source and push to your own registry. Pair it with the merchant-sdk OpenAPI examples for automated client generation.

build & run (illustrative — see gateway-infra/)
# inside the gateway-infra repo, on your own host:
docker compose --parallel=1 build
docker compose --parallel=1 up
05/ Open source

Verifiable infrastructure — not a black box.

merchant-sdk (the consumer-facing payment widget) is MIT-licensed; smart contracts, the backend, and the portals are source-included under the proprietary Web3Settle Software License. Audit the code, fork merchant-sdk for your own needs.

Star us on GitHub

Everything we ship is open for inspection — consumer widget, contract templates, webhook verification utilities, example integrations. If payment rails are going to handle your revenue, you deserve to read the code.

Star us on GitHub
Docs · SDK · API

Ship in under 10 minutes.

Hook the widget into your checkout, configure your webhook, and start settling on-chain — without anyone touching your funds.