Public API
    • Get Started
    • Payments
      • Create payment
        POST
      • List payments
        GET
      • Get payment by ID
        GET
    • Webhooks
      • Integration Guide
      • Webhook Definitions
        • Payment Created
        • Payment Completed
        • Payment Expired

    Get Started

    About Woldy
    Woldy is a fintech platform that lets merchants accept stablecoin payments with minimal setup. You create a payment — your customer pays in a few clicks — you get the funds.

    How It Works#

    Woldy handles the entire customer-facing experience on gateway.woldy.xyz. No blockchain code on your side — you only need to create the payment and listen for the result.

    Key Highlights#

    Hosted checkout — Woldy handles the wallet connection and transaction signing UX
    WalletConnect support — customers can connect any compatible wallet (MetaMask, Rainbow, Trust Wallet, and more)
    Stablecoin-native — USDT and USDC, no volatility risk
    EVM network support — Ethereum, Polygon, Arbitrum, Optimism, and Base
    Low fees — competitive transaction costs designed for real commerce
    Webhook notifications — get notified instantly when a payment status changes

    Get Your API Key#

    To start integrating, you need a Woldy merchant account and an API key.
    1.
    Sign up at merchant.woldy.xyz
    2.
    Go to Settings → API Keys
    3.
    Generate and copy your API key
    Include it in every API request as a header:
    Authorization: <your-api-key>
    Keep your API key secret. Never expose it in client-side code or public repositories.

    What's Available#

    ProductDescriptionStatus
    PaymentsAccept stablecoin payments via hosted checkout✅ Available
    PayoutsSend funds to external wallets🔜 Coming soon
    WebhooksReal-time payment status updates✅ Available

    Next Steps#

    Payments — Quick Start →
    Webhooks — Real-time event notifications→
    Open your Dashboard →
    Modified at 2026-03-18 09:11:58
    Next
    Payments
    Built with