Docs
Basics
API Reference
Basics
API Reference
  1. Merchant Dashboard
  • Introduction
  • Merchant Dashboard
    • Get Started
    • What is Branches
    • What is Vault and how Settlement works
  • Pay with Woldy
    • How to Pay 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:
access to the Merchant Dashboard
a verified merchant account
permission to manage development settings

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.
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: <your-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)
To receive real-time payment notifications.

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

What's Available#

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

Do you want to know more?#

What is Branches →
What is Vault and how Settlement works →
Open your Dashboard →
Modified at 2026-04-14 06:32:35
Previous
Introduction
Next
What is Branches
Built with