Skip to main content

Creating Payment Links

This guide walks you through creating, configuring, and sharing payment links. Whether you're selling products, accepting donations, or collecting payments for services, you'll learn how to set up effective payment links.

Before You Startโ€‹

Prerequisitesโ€‹

  • Active Omise account (test or live mode)
  • Business verification completed (for live mode)
  • Payment methods enabled in your account
  • Product or service details ready

What You'll Needโ€‹

  • Product/service name and description
  • Payment amount or price range
  • Product images (optional but recommended)
  • Logo for branding (optional)
  • Custom fields requirements (if any)
  1. Log in to your Omise Dashboard
  2. Navigate to Payment Links in the left sidebar
  3. Click Create Payment Link button

Screenshot description: Dashboard showing Payment Links section with "Create Payment Link" button highlighted in the top-right corner.

Step 2: Basic Informationโ€‹

Fill in the essential details:

  • Used for your reference only (not shown to customers)
  • Examples: "Product Launch Tee", "Consultation Fee", "Summer Sale"
  • Make it descriptive for easy management
Link Name: Graphic Design Consultation

Public Titleโ€‹

  • Displayed to customers on the payment page
  • Keep it clear and professional
  • Maximum 100 characters
Public Title: 1-Hour Graphic Design Consultation

Descriptionโ€‹

  • Explain what the customer is purchasing
  • Include key details and benefits
  • Supports basic HTML formatting
  • Maximum 500 characters
Description: Get expert advice on your design projects. 
Includes portfolio review, design strategy, and actionable
recommendations. Session delivered via video call.

Screenshot description: Form showing Link Name, Public Title, and Description fields with example consultation service details filled in.

Step 3: Configure Payment Amountโ€‹

Choose the pricing type that fits your needs:

Fixed Amountโ€‹

Single price for all customers:

  1. Select Fixed Amount
  2. Enter the amount
  3. Choose currency (THB, USD, etc.)
Amount: 1,500.00 THB

Use cases:

  • Product sales
  • Service packages
  • Event tickets
  • Course fees

Flexible Amountโ€‹

Customers choose the amount:

  1. Select Flexible Amount
  2. Set minimum amount (optional)
  3. Set maximum amount (optional)
  4. Set suggested amount (optional)
Minimum: 100.00 THB
Maximum: 10,000.00 THB
Suggested: 500.00 THB

Use cases:

  • Donations
  • Tips and gratuities
  • Custom orders
  • Pay-what-you-want pricing

Quantity-Based Pricingโ€‹

Fixed price with quantity selector:

  1. Select Quantity-Based
  2. Enter unit price
  3. Set maximum quantity (optional)
  4. Set default quantity
Unit Price: 450.00 THB
Max Quantity: 10
Default Quantity: 1

Use cases:

  • Physical products
  • Multiple tickets
  • Bulk purchases
  • Package deals

Screenshot description: Payment configuration panel showing three pricing options (Fixed, Flexible, Quantity-Based) with the Fixed Amount option selected and amount field showing 1,500 THB.

Step 4: Select Payment Methodsโ€‹

Choose which payment methods customers can use:

Enable Methodsโ€‹

Check the boxes for desired payment methods:

  • Credit/Debit Cards - Visa, Mastercard, Amex, JCB
  • Internet Banking - All major Thai banks
  • Mobile Banking - QR code payments
  • E-Wallets - TrueMoney, Rabbit LINE Pay, ShopeePay
  • Installments - 0% installment plans
โœ“ Credit/Debit Cards
โœ“ Internet Banking
โœ“ Mobile Banking
โœ“ TrueMoney Wallet
โœ“ Rabbit LINE Pay

Pro Tip: Enable multiple methods to maximize conversion. Customers prefer having options.

Payment Method Feesโ€‹

  • Different methods have different fees
  • Fees are automatically calculated
  • Customer sees total amount including fees
  • You receive the amount minus fees

Screenshot description: Payment methods selection panel with checkboxes for various payment options, showing Credit Cards, Internet Banking, and TrueMoney Wallet selected.

Step 5: Add Images and Brandingโ€‹

Make your payment link professional and trustworthy:

Product Imageโ€‹

  1. Click Upload Image
  2. Select image file (PNG, JPG, GIF)
  3. Maximum file size: 5MB
  4. Recommended dimensions: 800x600px or 1200x900px
  5. Image is displayed on payment page

Image Guidelines:

  • Use high-quality, clear images
  • Show product from best angle
  • Use clean background
  • Ensure good lighting
  • Optimize file size for fast loading
Image: consultation-service.jpg (800x600px, 450KB)
  1. Click Upload Logo
  2. Select logo file (PNG with transparency recommended)
  3. Maximum file size: 2MB
  4. Recommended dimensions: 200x200px or 400x400px
  5. Logo appears in header of payment page

Logo Guidelines:

  • Use transparent PNG for best results
  • Ensure logo is legible at small sizes
  • Use your brand colors
  • Square or horizontal format works best
Logo: company-logo.png (200x200px, 75KB)

Screenshot description: Image upload section showing thumbnail preview of uploaded product image and logo, with dimensions and file size displayed below each.

Step 6: Customize Appearance (Optional)โ€‹

Brand the payment page to match your business:

Brand Colorโ€‹

  1. Click on color picker
  2. Select your primary brand color
  3. Color is used for buttons and accents
  4. Ensure sufficient contrast for readability
Brand Color: #FF5722 (Coral Orange)

Custom CSS (Advanced)โ€‹

For advanced users only:

  • Add custom styling
  • Override default styles
  • Use carefully to maintain usability
  • Test thoroughly

Screenshot description: Color picker interface showing a brand color selection with the chosen color applied to a button preview below.

Step 7: Add Custom Fields (Optional)โ€‹

Collect additional information from customers:

Adding a Custom Fieldโ€‹

  1. Click Add Custom Field

  2. Choose field type:

    • Text (single line)
    • Textarea (multiple lines)
    • Select dropdown
    • Checkbox
    • Radio buttons
    • Date
    • Email
    • Phone number
  3. Configure field:

    • Field label
    • Placeholder text
    • Required or optional
    • Validation rules

Example: Collecting Delivery Addressโ€‹

Field Type: Textarea
Label: Delivery Address
Placeholder: Enter your full delivery address
Required: Yes
Max Length: 200 characters

Example: T-Shirt Size Selectionโ€‹

Field Type: Select Dropdown
Label: Size
Options:
- Small (S)
- Medium (M)
- Large (L)
- X-Large (XL)
Required: Yes

Example: Event Dietary Requirementsโ€‹

Field Type: Textarea
Label: Dietary Requirements
Placeholder: Any allergies or dietary restrictions?
Required: No
Max Length: 150 characters

Common Custom Fields:

  • Shipping address
  • Phone number for delivery
  • Special instructions
  • Gift message
  • Event preferences
  • Customization details

Screenshot description: Custom fields configuration panel showing three example fields (Delivery Address, Size, Dietary Requirements) with their types and settings displayed.

Set up link behavior and expiration:

Choose between multi-use or single-use:

Multi-Use Link

  • Can be used by multiple customers
  • Remains active until disabled or expired
  • Good for general sales
  • Easier to share widely
Type: Multi-Use

Single-Use Link

  • Expires after first successful payment
  • Good for unique invoices
  • More secure for sensitive transactions
  • Automatically disabled after use
Type: Single-Use

Expiration Settingsโ€‹

No Expiration

  • Link remains active indefinitely
  • Must be manually disabled
  • Good for ongoing products/services
Expiration: None

Expire After Date/Time

  • Automatically disables at set time
  • Good for limited-time offers
  • Timezone-aware
Expire On: 2026-12-31 23:59:59 ICT

Expire After First Payment

  • Only for single-use links
  • Automatic expiration
  • Good for invoices
Expiration: After First Payment

Redirect After Paymentโ€‹

Optionally redirect customers after successful payment:

Success URL: https://yoursite.com/thank-you
(Optional)

Use cases for redirect:

  • Show custom thank you page
  • Provide download links
  • Display order confirmation
  • Collect additional information

Screenshot description: Link settings panel showing Link Type dropdown set to "Multi-Use" and expiration settings with a date picker set to December 31, 2026.

Step 9: Set Up Notificationsโ€‹

Configure how you'll be notified about payments:

Email Notificationsโ€‹

  • Sent to account email by default
  • Add additional recipient emails
  • Immediate notification on payment
  • Includes transaction details
Notify: merchant@yourcompany.com, sales@yourcompany.com

Webhook Notifications (Advanced)โ€‹

For developers who want real-time data:

  1. Enable webhook notifications
  2. Enter webhook endpoint URL
  3. Select events to receive:
    • Payment successful
    • Payment failed
    • Link viewed
    • Link expired
Webhook URL: https://yoursite.com/webhooks/omise
Events: payment.succeeded, payment.failed

Screenshot description: Notifications settings showing email notification fields with two email addresses entered and webhook configuration section below.

Step 10: Review and Createโ€‹

Before creating the link:

  1. Review All Details

    • Check payment amount
    • Verify description accuracy
    • Ensure images look good
    • Confirm payment methods
    • Test custom fields
  2. Preview Payment Page

    • Click Preview button
    • See exactly what customers will see
    • Test on mobile view
    • Check all elements
  3. Create Link

    • Click Create Payment Link
    • Link is generated instantly
    • Redirected to link details page

Screenshot description: Review page showing summary of all configured settings with a preview of the payment page on the right side and "Create Payment Link" button at the bottom.

After creation, you'll see:

Payment Link Created Successfully!

Link URL: https://pay.omise.co/links/payl_test_5xyx8z94w46ixr9l
Short URL: https://omise.link/abc123
QR Code: [QR Code Image]

Multiple options to copy:

  1. Full URL
    • Click Copy Link button
    • Standard Omise payment link format
    • Use in emails, documents
https://pay.omise.co/links/payl_test_5xyx8z94w46ixr9l
  1. Short URL
    • Click Copy Short Link
    • Easier to share
    • Better for social media
    • Redirects to full link
https://omise.link/abc123

Screenshot description: Link details page showing the full URL, short URL, and QR code with copy buttons next to each URL.

Downloading QR Codeโ€‹

Perfect for offline marketing:

  1. Click Download QR Code
  2. Choose format:
    • PNG (recommended)
    • SVG (vector, for print)
    • PDF (for documents)
  3. Select size:
    • Small (300x300px)
    • Medium (600x600px)
    • Large (1200x1200px)
    • Custom size

QR Code Use Cases:

  • Print on flyers and posters
  • Display at physical locations
  • Add to business cards
  • Include in presentations
  • Share on social media

Screenshot description: QR code download dialog showing format options (PNG, SVG, PDF) and size options with preview of QR code.

Sharing Optionsโ€‹

Via Emailโ€‹

Subject: Invoice for Graphic Design Consultation

Dear Client,

Please find your payment link below:
https://omise.link/abc123

Amount: THB 1,500.00
Description: 1-Hour Graphic Design Consultation

Click the link to complete your payment securely.

Thank you!

Via Social Mediaโ€‹

Instagram/Facebook:

  • Add to bio link
  • Include in post captions
  • Share in stories with "Swipe Up" (if available)
  • Use link-in-bio tools
๐Ÿ“ข New service available! Book your design consultation now.
Link in bio ๐Ÿ‘†
#graphicdesign #consultation

Twitter:

  • Include in tweets
  • Pin to profile
  • Use with shortened URL
๐ŸŽจ Need design advice? Book a 1-hour consultation now!
https://omise.link/abc123

Via Messaging Appsโ€‹

LINE, WhatsApp, Telegram:

Hi! Thanks for your interest. You can complete your 
purchase here: https://omise.link/abc123

Let me know if you have any questions!

On Your Websiteโ€‹

HTML Link:

<a href="https://omise.link/abc123" 
class="btn btn-primary">
Buy Now - THB 1,500
</a>

Button Example:

<a href="https://omise.link/abc123" 
style="display: inline-block; padding: 12px 24px;
background: #FF5722; color: white;
text-decoration: none; border-radius: 4px;">
Purchase Consultation
</a>

Test Mode Testingโ€‹

  1. Switch to Test Mode

    • Use test mode link for testing
    • No real charges made
    • Test all payment flows
  2. Test Different Scenarios

    • Successful payment
    • Failed payment
    • Different payment methods
    • Custom field validation
    • Mobile experience
  3. Use Test Cards

Successful Payment:
Card: 4242 4242 4242 4242
Expiry: 01/26
CVV: 123
Name: Test User

Failed Payment:
Card: 4000 0000 0000 0002
Expiry: 01/26
CVV: 123
Name: Test User

Testing Checklistโ€‹

  • Link opens correctly
  • Images and logo display properly
  • Payment amount is correct
  • All payment methods work
  • Custom fields validate properly
  • Success message displays
  • Email notifications received
  • Webhook notifications work (if configured)
  • Mobile experience is smooth
  • QR code scans correctly

Screenshot description: Test payment page showing test mode banner at top and successful test payment confirmation message.

Navigate to Payment Links dashboard:

  • View all active links
  • See inactive/expired links
  • Check link performance
  • Quick access to URLs and QR codes

List View Shows:

  • Link name
  • Amount
  • Created date
  • Status (Active/Inactive/Expired)
  • Total payments
  • Total revenue
  • Actions (Edit, View, Disable)

Screenshot description: Payment Links dashboard showing a table with multiple payment links, their status, payment counts, and revenue totals.

  1. Click on link name or Edit button
  2. Modify allowed fields:
    • Description
    • Images
    • Custom fields
    • Payment methods
    • Expiration date
    • Notifications

Cannot Change:

  • Amount (if link has existing payments)
  • Currency
  • Link URL
  1. Click Save Changes

Temporarily or permanently disable:

  1. Click Disable button
  2. Confirm action
  3. Link becomes inaccessible
  4. Can be re-enabled later

When to Disable:

  • Product out of stock
  • Service no longer offered
  • Promotional period ended
  • Security concerns
  • Testing completion

Create similar links quickly:

  1. Click Duplicate button
  2. New link created with same settings
  3. Modify as needed
  4. New unique URL generated

Use Cases:

  • Create similar product variants
  • Run A/B tests with different descriptions
  • Set up seasonal promotions
  • Create links for different markets

Save time with templates:

  1. Create Template

    • Set up link with common settings
    • Save as template
    • Reuse for similar products
  2. Use Template

    • Click Create from Template
    • Select template
    • Customize specific details
    • Create link

Common Templates:

  • Product sales
  • Service bookings
  • Event tickets
  • Donations
  • Invoices

For creating many links:

  1. Prepare CSV File
name,title,description,amount,currency
Product A,Red T-Shirt,100% cotton,450,THB
Product B,Blue T-Shirt,100% cotton,450,THB
Product C,Green T-Shirt,100% cotton,450,THB
  1. Import CSV

    • Navigate to Payment Links
    • Click Import CSV
    • Upload file
    • Review and confirm
    • Links created in bulk
  2. Review Created Links

    • Check all links created correctly
    • Test sample links
    • Download QR codes in bulk

Screenshot description: CSV import interface showing file upload area and preview of CSV data with columns for name, title, description, amount, and currency.

API Creationโ€‹

For developers who want automation:

const omise = require('omise')({
secretKey: 'skey_test_xxx'
});

omise.links.create({
amount: 150000, // 1,500.00 THB in smallest currency unit
currency: 'thb',
title: '1-Hour Graphic Design Consultation',
description: 'Expert advice on your design projects',
multiple: true // Multi-use link
}, function(error, link) {
if (error) {
console.error('Error:', error);
} else {
console.log('Link created:', link.payment_uri);
}
});

See Payment Links API for full documentation.

Best Practicesโ€‹

  1. Be Descriptive

    • Use clear, specific titles
    • Include all relevant details in description
    • Explain what customer receives
    • Set expectations clearly
  2. Use Quality Images

    • High resolution but optimized file size
    • Show product clearly
    • Use multiple angles if possible
    • Consistent lighting and background
  3. Enable Multiple Payment Methods

    • More options = higher conversion
    • Consider target audience preferences
    • Enable popular methods in your market
    • Test different combinations
  4. Set Appropriate Expiration

    • Time-limited offers: set expiry date
    • Invoices: set reasonable payment deadline
    • General products: no expiration needed
    • Single-use for unique transactions
  5. Test Thoroughly

    • Always test in test mode first
    • Try different payment methods
    • Test on multiple devices
    • Verify notifications work

Sharing Strategyโ€‹

  1. Choose Right Channel

    • Social media: short links
    • Email: full links with context
    • Print materials: QR codes
    • Website: buttons and links
  2. Provide Context

    • Explain what the payment is for
    • Include amount information
    • Mention accepted payment methods
    • Add urgency if time-sensitive
  3. Track Performance

    • Monitor which channels perform best
    • Track conversion rates
    • A/B test different descriptions
    • Adjust strategy based on data
  4. Make It Easy

    • Remove friction from payment process
    • Use short URLs when possible
    • Ensure mobile-friendly
    • Clear call-to-action

Securityโ€‹

  1. Protect Sensitive Links

    • Don't share single-use links publicly
    • Use expiration for time-sensitive offers
    • Monitor for unusual activity
    • Disable compromised links immediately
  2. Verify Payments

    • Check dashboard regularly
    • Verify payment amounts
    • Watch for failed payments
    • Investigate suspicious activity
  3. Customer Data

    • Only collect necessary information
    • Protect custom field data
    • Don't request sensitive info
    • Comply with privacy regulations

Common Use Case Examplesโ€‹

Example 1: Selling Digital Productsโ€‹

Scenario: Selling an e-book for THB 299

Link Name: E-book Sale - SEO Guide 2026
Public Title: The Complete SEO Guide 2026
Description: Comprehensive 200-page guide covering
latest SEO strategies, case studies, and actionable tips.
Instant PDF download after payment.

Amount: 299.00 THB (Fixed)
Payment Methods: Cards, TrueMoney, Rabbit LINE Pay
Link Type: Multi-Use
Expiration: None
Success URL: https://yoursite.com/downloads/seo-guide

Custom Fields:
- Email Address (required, for sending download link)

Example 2: Event Registrationโ€‹

Scenario: Conference ticket sales with early bird pricing

Link Name: Tech Conference 2026 - Early Bird
Public Title: Tech Conference 2026 Ticket
Description: Join us for 2 days of inspiring talks,
workshops, and networking. Early bird price valid until
March 31. Includes lunch, coffee, and conference materials.

Amount: 2,500.00 THB (Fixed)
Payment Methods: Cards, Internet Banking, Installments
Link Type: Multi-Use
Expiration: 2026-03-31 23:59:59 ICT

Custom Fields:
- Full Name (required)
- Email (required)
- Phone Number (required)
- Company (optional)
- Dietary Requirements (optional)
- T-Shirt Size (required, dropdown: S/M/L/XL)

Example 3: Service Depositโ€‹

Scenario: Photography session deposit

Link Name: Wedding Photography Deposit - [Client Name]
Public Title: Wedding Photography Service Deposit
Description: Deposit for wedding photography package.
Balance due on event day. Deposit is non-refundable but
can be rescheduled once.

Amount: 5,000.00 THB (Fixed)
Payment Methods: Cards, Internet Banking
Link Type: Single-Use
Expiration: After First Payment

Custom Fields:
- Wedding Date (required, date picker)
- Venue Location (required)
- Contact Phone (required)
- Special Requests (optional, textarea)

Example 4: Flexible Donationsโ€‹

Scenario: Charity fundraising campaign

Link Name: Animal Shelter Donation Drive
Public Title: Support Our Animal Shelter
Description: Your donation helps us provide food, medical
care, and shelter for abandoned animals. Every baht makes
a difference. Thank you for your kindness!

Amount: Flexible (Min: 100 THB, Suggested: 500 THB)
Payment Methods: All methods enabled
Link Type: Multi-Use
Expiration: 2026-12-31 23:59:59 ICT

Custom Fields:
- Donor Name (optional, for receipt)
- Email (optional, for updates)
- Dedication Message (optional, textarea)
- Anonymous Donation (checkbox)

Example 5: Product with Variantsโ€‹

Scenario: T-shirt sales with size selection

Link Name: Limited Edition T-Shirt - Black
Public Title: Limited Edition Designer T-Shirt
Description: Premium 100% organic cotton. Limited to 100
pieces. Unisex fit. Free shipping for orders over THB 1,000.

Amount: 550.00 THB (Quantity-Based, Max: 5)
Payment Methods: Cards, TrueMoney, Rabbit LINE Pay
Link Type: Multi-Use
Expiration: When sold out or 2026-06-30

Custom Fields:
- Size (required, dropdown: XS/S/M/L/XL/XXL)
- Shipping Address (required, textarea)
- Phone Number (required)
- Gift Wrapping (optional, checkbox, +50 THB)

Troubleshootingโ€‹

Common Issuesโ€‹

Issue: Link not opening

  • Check if link is active
  • Verify expiration hasn't passed
  • Ensure not single-use already used
  • Try different browser
  • Clear browser cache

Issue: Payment methods not showing

  • Verify methods enabled in account
  • Check method availability for currency
  • Ensure account verification complete
  • Contact support for capability issues

Issue: Images not displaying

  • Check image file size (max 5MB)
  • Verify image format (PNG, JPG, GIF)
  • Ensure image URL is accessible
  • Try uploading again
  • Use different image file

Issue: Custom fields not working

  • Check field validation rules
  • Verify required fields have values
  • Test field on different devices
  • Ensure field names don't conflict
  • Review error messages

Issue: Notifications not received

  • Verify email address is correct
  • Check spam/junk folder
  • Confirm notifications are enabled
  • Test with different email address
  • Check webhook endpoint (if using)

Issue: Redirect not working

  • Verify URL is correct and accessible
  • Ensure URL uses HTTPS
  • Check URL doesn't require authentication
  • Test URL in browser
  • Look for URL encoding issues

Frequently Asked Questionsโ€‹

Q: How quickly can I create a payment link?
A: A basic payment link with title, amount, and description can be created in under 2 minutes. Adding images, custom fields, and advanced settings may take 5-10 minutes.

Q: Can I edit the link URL after creation?
A: No, the link URL is permanent. However, you can disable the old link and create a new one with a different URL if needed.

Q: What happens if a link expires?
A: Expired links show an error message to customers saying the link is no longer valid. You can update the expiration date or create a new link.

Q: Can I see who clicked on my link before paying?
A: No, you can only see view counts, not individual visitors. Customer information is only captured when they complete a payment.

Q: How do I delete a payment link?
A: You cannot delete payment links that have transactions. You can disable them to make them inaccessible. Links with no transactions can be deleted from the dashboard.

Q: Can I use the same link for different amounts?
A: No, each link has a fixed amount (or flexible range). Create separate links for different pricing. Consider using quantity-based pricing if appropriate.

Q: Do QR codes expire when the link expires?
A: Yes, QR codes point to the payment link. If the link expires or is disabled, the QR code will also stop working.

Q: Can I track conversions from different marketing channels?
A: Use different links for each channel or add URL parameters (though parameters are not passed through). Better approach is creating separate links for tracking.

Q: What information can I collect with custom fields?
A: You can collect text, selections, dates, and checkbox data. Do not collect sensitive payment information (card numbers, etc.) as this is handled by Omise.

Q: Can I issue refunds for payment link transactions?
A: Yes, refunds are processed through the dashboard like any other transaction. Navigate to the transaction and click "Refund".

Q: How long do customers have to complete payment after clicking the link?
A: Once on the payment page, the session is typically valid for 15 minutes. After that, they need to click the link again to start a new session.

Q: Can I create payment links in multiple languages?
A: The dashboard is in English, but you can write the title and description in any language. The payment page UI language is based on customer's browser settings.

Next Stepsโ€‹

Now that you know how to create payment links:

  1. Customization Guide - Learn advanced customization techniques
  2. Payment Links API - Automate link creation with code
  3. Dashboard Guide - Learn to manage payments effectively
  4. Testing Guide - Test your payment links thoroughly

Additional Resourcesโ€‹


Need help? Contact our support team at support@omise.co or visit the Help Center.