Cancel payment link

POST

/payment-links/{payment_link_id}/cancel

Cancels a PENDING payment link. No request body — CANCELLED is
the only reachable status through this endpoint. Cancelling a link
that is not currently PENDING (already CANCELLED, COMPLETED,
EXPIRED, or PROCESSING) returns 400, not 409.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Payment link cancelled

Bodyapplication/json

🟠400

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://public-api.woldy.xyz/v1/payment-links//cancel' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 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

Get payment link

List charges