Create payment link

POST

/payment-links

Creates a payment link in PENDING status with source API and
type FIXED (flexible-amount links cannot be created through this
endpoint). payment_url in the response is where the customer
completes payment.

There is no idempotency key — submitting the same body twice
creates two distinct payment links.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Payment link created

Bodyapplication/json

🟠400ValidationError

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

cURL

Minimal requestAll optional fields set

curl --location 'https://public-api.woldy.xyz/v1/payment-links' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "price_amount": "10.00",
    "price_currency": "USD",
    "expires_at": "2026-08-01T00:00:00Z"
}'

Response Example

201 - Example 1

{
    "id": "pl_AAAA...",
    "branch_id": "cb_AAAA...",
    "reference_type": "PAYMENT_LINK",
    "status": "PENDING",
    "source": "DASHBOARD",
    "type": "FIXED",
    "chain_id": "eip155:8453",
    "price_currency": "USD",
    "price_amount": "10.00",
    "pay_currency": "USDC",
    "pay_amount": "10.00",
    "message": "Order #12345",
    "payment_url": "https://gateway.woldy.xyz/pl/AZ-X2wuJfQ-aFbMIEo_Klg",
    "return_url": "https://example.com/success",
    "external_id": "order_123",
    "expires_at": "2019-08-24T14:15:22.123Z",
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-08-19 07:13:55

Webhooks

List payment links