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)
Creating Your First Payment Linkโ
Step 1: Access Payment Linksโ
- Log in to your Omise Dashboard
- Navigate to Payment Links in the left sidebar
- 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:
Link Name (Internal)โ
- 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:
- Select Fixed Amount
- Enter the amount
- 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:
- Select Flexible Amount
- Set minimum amount (optional)
- Set maximum amount (optional)
- 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:
- Select Quantity-Based
- Enter unit price
- Set maximum quantity (optional)
- 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โ
- Click Upload Image
- Select image file (PNG, JPG, GIF)
- Maximum file size: 5MB
- Recommended dimensions: 800x600px or 1200x900px
- 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)
Logoโ
- Click Upload Logo
- Select logo file (PNG with transparency recommended)
- Maximum file size: 2MB
- Recommended dimensions: 200x200px or 400x400px
- 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โ
- Click on color picker
- Select your primary brand color
- Color is used for buttons and accents
- 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โ
-
Click Add Custom Field
-
Choose field type:
- Text (single line)
- Textarea (multiple lines)
- Select dropdown
- Checkbox
- Radio buttons
- Date
- Phone number
-
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.
Step 8: Configure Link Settingsโ
Set up link behavior and expiration:
Link Typeโ
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:
- Enable webhook notifications
- Enter webhook endpoint URL
- 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:
-
Review All Details
- Check payment amount
- Verify description accuracy
- Ensure images look good
- Confirm payment methods
- Test custom fields
-
Preview Payment Page
- Click Preview button
- See exactly what customers will see
- Test on mobile view
- Check all elements
-
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.
Accessing and Sharing Your Linkโ
Link Details Pageโ
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]
Copying the Linkโ
Multiple options to copy:
- Full URL
- Click Copy Link button
- Standard Omise payment link format
- Use in emails, documents
https://pay.omise.co/links/payl_test_5xyx8z94w46ixr9l
- 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:
- Click Download QR Code
- Choose format:
- PNG (recommended)
- SVG (vector, for print)
- PDF (for documents)
- 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>
Testing Your Payment Linkโ
Test Mode Testingโ
-
Switch to Test Mode
- Use test mode link for testing
- No real charges made
- Test all payment flows
-
Test Different Scenarios
- Successful payment
- Failed payment
- Different payment methods
- Custom field validation
- Mobile experience
-
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.
Managing Your Payment Linksโ
Viewing All Linksโ
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.
Editing a Linkโ
- Click on link name or Edit button
- Modify allowed fields:
- Description
- Images
- Custom fields
- Payment methods
- Expiration date
- Notifications
Cannot Change:
- Amount (if link has existing payments)
- Currency
- Link URL
- Click Save Changes
Disabling a Linkโ
Temporarily or permanently disable:
- Click Disable button
- Confirm action
- Link becomes inaccessible
- Can be re-enabled later
When to Disable:
- Product out of stock
- Service no longer offered
- Promotional period ended
- Security concerns
- Testing completion
Duplicating a Linkโ
Create similar links quickly:
- Click Duplicate button
- New link created with same settings
- Modify as needed
- 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
Advanced Link Creationโ
Using Link Templatesโ
Save time with templates:
-
Create Template
- Set up link with common settings
- Save as template
- Reuse for similar products
-
Use Template
- Click Create from Template
- Select template
- Customize specific details
- Create link
Common Templates:
- Product sales
- Service bookings
- Event tickets
- Donations
- Invoices
Bulk Link Creationโ
For creating many links:
- 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
-
Import CSV
- Navigate to Payment Links
- Click Import CSV
- Upload file
- Review and confirm
- Links created in bulk
-
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โ
Link Creationโ
-
Be Descriptive
- Use clear, specific titles
- Include all relevant details in description
- Explain what customer receives
- Set expectations clearly
-
Use Quality Images
- High resolution but optimized file size
- Show product clearly
- Use multiple angles if possible
- Consistent lighting and background
-
Enable Multiple Payment Methods
- More options = higher conversion
- Consider target audience preferences
- Enable popular methods in your market
- Test different combinations
-
Set Appropriate Expiration
- Time-limited offers: set expiry date
- Invoices: set reasonable payment deadline
- General products: no expiration needed
- Single-use for unique transactions
-
Test Thoroughly
- Always test in test mode first
- Try different payment methods
- Test on multiple devices
- Verify notifications work
Sharing Strategyโ
-
Choose Right Channel
- Social media: short links
- Email: full links with context
- Print materials: QR codes
- Website: buttons and links
-
Provide Context
- Explain what the payment is for
- Include amount information
- Mention accepted payment methods
- Add urgency if time-sensitive
-
Track Performance
- Monitor which channels perform best
- Track conversion rates
- A/B test different descriptions
- Adjust strategy based on data
-
Make It Easy
- Remove friction from payment process
- Use short URLs when possible
- Ensure mobile-friendly
- Clear call-to-action
Securityโ
-
Protect Sensitive Links
- Don't share single-use links publicly
- Use expiration for time-sensitive offers
- Monitor for unusual activity
- Disable compromised links immediately
-
Verify Payments
- Check dashboard regularly
- Verify payment amounts
- Watch for failed payments
- Investigate suspicious activity
-
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:
- Customization Guide - Learn advanced customization techniques
- Payment Links API - Automate link creation with code
- Dashboard Guide - Learn to manage payments effectively
- Testing Guide - Test your payment links thoroughly
Additional Resourcesโ
Need help? Contact our support team at support@omise.co or visit the Help Center.