PayzCore Docs

Payment Links

Create shareable payment links for quick, no-code payment collection.

Payment Links

Payment Links let you accept stablecoin payments without writing any code. Create a link in the dashboard, share it with your customers, and PayzCore handles the rest.

How It Works

1. Create a payment link in the dashboard (title, amount, token)
2. Share the URL: pay.payzcore.com/l/your-slug
3. Customer opens the link, fills in their info, clicks "Continue to Payment"
4. PayzCore creates a payment, customer selects network and pays
5. You receive a webhook notification when payment completes

Each payment link is tied to a project. The project's wallet, webhook URL, and settings apply to all payments created through the link.

  1. Go to Payment Links in the dashboard sidebar
  2. Click Create Link
  3. Fill in the details:
FieldRequiredDescription
ProjectYesWhich project receives the payments
TitleYesDisplayed to the buyer (e.g., "Premium Plan", "Donation")
SlugYesURL path — pay.payzcore.com/l/{slug}. Auto-generated from title, editable. Lowercase letters, numbers, and hyphens only.
Amount TypeYesFixed (you set the price) or Open (buyer enters the amount)
AmountIf fixedPayment amount in USD (min $0.10)
TokenYesUSDT or USDC
DescriptionNoAdditional context shown to the buyer
Buyer FieldsYesConfigure which fields the buyer sees (see below)

Buyer Information Fields

You can control what information to collect from the buyer:

FieldOptionsDefault
EmailRequired / Optional / HiddenRequired
NameRequired / Optional / HiddenOptional
NoteRequired / Optional / HiddenOptional

Buyer information is stored in the payment's metadata field and included in webhook payloads:

{
  "metadata": {
    "_buyer_email": "[email protected]",
    "_buyer_name": "John Doe",
    "_buyer_note": "Order #1234",
    "_payment_link_id": "uuid",
    "_payment_link_slug": "premium-plan"
  }
}

Buyer fields use the _ prefix to avoid collisions with your own metadata keys.

The Buyer Experience

When a customer opens your payment link:

  1. They see your store name, logo, and verified badge (if your project is verified)
  2. They fill in the required fields (email, name, note — based on your configuration)
  3. For open amount links, they enter how much they want to pay
  4. They click Continue to Payment
  5. They're redirected to the standard PayzCore payment page where they select a network and send the payment

Unverified Merchant Warning

If your project is not verified by an admin, buyers will see an "Unverified Merchant" warning badge. This helps protect buyers from potential scams. Contact support to get your project verified.

Dashboard

The Payment Links page shows all your links with:

  • Title, slug, and status (active/inactive)
  • Amount type and token
  • Payment count and total amount received
  • Creation date

Click any link to view its detail page with full stats and a list of all payments created through it.

Actions

ActionDescription
Copy URLCopy the payment link URL to clipboard
Toggle ActiveEnable or disable the link. Disabled links show "Payment Link Unavailable" to visitors.
DeletePermanently remove the link. Existing payments are not affected.

Editing

Payment link settings (title, amount, fields) are set at creation and cannot be changed afterward. To modify settings, create a new link and deactivate the old one.

Webhooks

Payments created through payment links trigger the same webhook events as API-created payments:

  • payment.completed — Full payment received
  • payment.overpaid — More than expected
  • payment.expired — Payment window expired
  • payment.partial — Partial payment

The webhook payload includes metadata with the buyer information and _payment_link_slug to identify which link originated the payment.

Rate Limits

Payment link pages are public (no authentication required). To prevent abuse:

  • 10 payment creations per minute per IP address
  • 100 payment creations per hour per payment link slug

These limits are separate from your API rate limits.

Store Branding

Payment link pages display your project's branding. Configure these in Project Settings:

SettingWhere it appears
Store NameHeader of the payment page
Store LogoNext to the store name
Brand ColorAccent color on the payment page
Support EmailShown when the link is inactive ("Contact the merchant")

Example Use Cases

  • Digital products — Sell ebooks, courses, or software with a fixed-price link
  • Donations — Accept open-amount contributions
  • Invoicing — Send a payment link instead of bank details
  • One-time services — Freelance work, consulting sessions
  • Subscriptions — Create a link for each billing period (manual renewal)

Limits

You can create a limited number of payment links based on your plan. The limit counts across all projects you own.

PlanPayment Links
Free3
Pro25

Payments created through links count toward your daily webhook and API call quotas as usual. Account administrators can set custom payment link limits for individual users.

If you need more payment links, upgrade to Pro or contact your administrator for a custom override.

See Also

On this page