Payments API — Accept Stablecoin Payments via Hosted Checkout

Accept stablecoin payments from customers via a hosted checkout page. You create a payment — Woldy handles the rest.

Two Ways to Create a Payment

	Dashboard	REST API
Best for	Non-technical merchants, one-off payments	Developers, automated checkout flows
Setup time	< 1 min	~30 min
Requires code	No	Yes
Webhooks	✅	✅

Quick Start

Step 1 — Create a payment

Send a POST request to create a payment. Woldy returns a hosted checkout URL to send to your customer.

See API Reference: Create payment

Step 2 — Send the customer to `payment_url`

Redirect your customer to the payment_url from the response. On that page the customer will:

Connect their wallet via WalletConnect

Review the payment amount

Sign and submit the transaction

Woldy handles everything from here. No additional code needed on your side.

Step 3 — Listen for the result

Set up a webhook endpoint to receive real-time status updates. When the payment is completed or expires, Woldy sends a POST request to your webhook URL.

Configure your webhook URL in Dashboard → Settings → Webhooks.

Step 4 — (Optional) Poll for status

If you prefer polling over webhooks, you can fetch the payment state at any time:

See API Reference: Get payment by ID

Payment Statuses

Status	Meaning
`PENDING`	Payment created, waiting for the customer to pay
`COMPLETED`	Transaction confirmed on-chain
`EXPIRED`	Customer did not pay before `expires_at`

API Reference

Endpoint	Method	Description
`/v1/payments`	`POST`	Create a new payment
`/v1/payments`	`GET`	List payments
`/v1/payments/{id}`	`GET`	Get a single payment by ID

Error Reference

Status	Meaning
`400 Bad Request`	Invalid request body — check required fields
`401 Unauthorized`	Missing or invalid API key
`429 Too Many Requests`	Rate limit exceeded — back off and retry
`500 Internal Server Error`	Something went wrong on our end — contact support

Payments

Two Ways to Create a Payment#

Quick Start#

Step 1 — Create a payment#

Step 2 — Send the customer to payment_url#

Step 3 — Listen for the result#

Step 4 — (Optional) Poll for status#

Payment Statuses#

API Reference#

Error Reference#