RevKeenDocs

Checkout Links

Reusable hosted checkout URLs for products, campaigns, and no-code payment flows

Checkout links are reusable hosted payment URLs. They are the simplest way to publish a purchase flow without building your own checkout page.

Best For

  • Product sales from landing pages
  • Email and SMS campaigns
  • QR codes for in-person sales or printed materials
  • No-code payment collection from the dashboard
  1. You create a payment link in RevKeen.
  2. RevKeen generates a public checkout URL for that link.
  3. The customer opens the hosted checkout page and pays.
  4. RevKeen creates or updates the downstream billing objects for the purchase.

The exact public URL format can vary by environment and branded domain. Copy the link RevKeen generates instead of constructing the URL yourself.

  1. Go to Dashboard > Payment Links.
  2. Click Create.
  3. Add one or more products or line items.
  4. Choose the checkout presentation you want RevKeen to use for the hosted flow.
  5. Configure optional behavior such as success URL, cancel URL, shipping collection, discounts, or expiry.
  6. Save the link and copy the generated public URL.

What You Can Configure

CapabilitySupported
One or more linked productsYes
Ad hoc line itemsYes
Success redirectYes
Cancel redirectYes
Shipping collectionYes
Promotion codesYes
Tax behaviorYes
Expiry timestampYes
MetadataYes
Link status managementYes
Hosted display mode selectionYes

Payment links support different billing use cases:

ModeUse when
customYou want a general hosted payment link
invoiceYou want the link tied to a specific invoice
subscriptionYou want the link tied to a subscription flow

API Example

If you want to create links programmatically, use the payment-links API.

curl -X POST "https://api.revkeen.com/v2/payment-links" \
  -H "x-api-key: $REVKEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Starter plan",
    "mode": "custom",
    "line_items": [
      {
        "price": "00000000-0000-0000-0000-000000000000",
        "quantity": 1
      }
    ],
    "success_url": "https://example.com/success",
    "cancel_url": "https://example.com/cancel",
    "allow_promotion_codes": true
  }'

Status Lifecycle

Payment links can move through the following states:

StatusMeaning
draftCreated but not yet active for customers
activeLive and usable
expiredNo longer usable because the link expired
completedUsed for a completed one-time flow

For operational management, RevKeen also supports active, inactive, and archived status transitions on the management endpoints.

Important Notes

  • Checkout links are designed to be reused. If you need a single checkout created per user action, use a checkout session instead.
  • Hosted payment-link checkout is currently card-focused.
  • If you need per-session method control such as card versus in-store, use the checkout-session API.