Docs
Basics
API Reference
Basics
API Reference
  1. Merchant Dashboard
  • Introduction
  • Merchant Dashboard
    • Get Started
    • What is Branches
    • What is Wallet
    • What is Vault and how Settlement works
    • What is Payins
  • Pay with Woldy
    • How to Pay with Woldy
    • How to Subscribe with Woldy
  1. Merchant Dashboard

Get Started

To start accepting payments with Woldy, you need a merchant account and an API key.
This guide helps you set up access to the Merchant Dashboard, generate your API key, and prepare your account for the first API request.

Before you begin#

Make sure you have:
a business or product you want to accept stablecoin payments for
an email address to register your merchant account

How to get started#

1
Create an account
Go to merchant.woldy.xyz and sign up for a merchant account.
2
Log in to the Dashboard
Once your account is ready, log in to the Merchant Dashboard.
3
Open Settings
In the Dashboard, go to Settings and find the Development section.
You'll need permission to manage development settings — if the section isn't visible, ask your account admin.
4
Generate an API key
Create a new API key for server-side API requests.
Copy and save your API key immediately — it is shown only once.
Include it in every API request as a header:
Authorization: Bearer <api-key>
Keep your API key secret. Never expose it in client-side code or public repositories. If a key is compromised, revoke it immediately from the Dashboard and generate a new one.
5
Set up a webhook (recommended)
Add a webhook URL in Settings → Webhooks to receive real-time payment status updates instead of polling the API.
See Webhooks → for event types and payload format.

What you can do next#

Once your account is set up, you can:
create payment sessions
redirect customers to hosted checkout
receive payment status updates via webhooks
manage payment activity from the Dashboard

Do you want to know more?#

What is Branches →
What is Wallet →
What is Vault and how Settlement works →
What is Payins →
Open your Dashboard →
Modified at 2026-08-23 11:13:44
Previous
Introduction
Next
What is Branches
Built with