Online Use Case
Overview
Optty’s Hosted Payment Page (HPP) solution streamlines the way merchants collect payments for invoices. Whether online or in-store, this tool allows you to generate secure, shareable links that enable customers to pay using their preferred Optty payment methods.
The checkout experience ensures consistency across all channels. While these pages can be generated manually as explained below via the Optty Universal Payment Platform (UPP), the process can also be fully automated via API to enable the bulk generation and distribution of payment links.
1. Manually Generating a Hosted Payment Page
You can generate Hosted Payment Page links directly through the Optty UPP interface or programmatically via the API.
Manual Generation via UPP To manually create a link for a customer:
Navigate to the sidebar of your Optty UPP dashboard.
Locate the Optty-Direct tab.
Select Get-Paid.
Select Create Invoice
Enter the required transaction details (amount, reference, currency).
Once the details are confirmed, the system generates a unique payment session.
Note for Developers: If you wish to automate this process within your own invoicing system, please refer to the Optty Direct Sessions section in our API reference documentation Optty Direct Sessions

2. Sharing a Hosted Payment Page
Once the payment session is created, there are several ways to deliver the payment request to your customer.
QR Code: On completion of generating a payment link, a QR Code is displayed. If the customer is with you, you can get them to scan it or access to the payment link.
Direct URL: Copy the generated URL at the end of the creation journey and share it via SMS, WhatsApp, or your own communication channels.
Automatic Email: Optty automatically dispatch's an email to the recipient's address entered during generation.
Branding and Whitelabeling the visual style of the email and the payment page depends on your configuration:
Whitelabeled Instances: The email and payment link will reflect your specific UPP branding (logos, colors, and domain).
Standard Instances: The communication will be sent with standard Optty branding.

3. Customer Makes Payment
The customer journey is designed to be frictionless and secure. Upon clicking the link or scanning the QR code, the customer is directed to the checkout page.
The Checkout Flow:
Billing Information: The customer enters any required billing details necessary for the enabled Alternative Payment Methods (APMs).
Method Selection: The customer selects their preferred APM (e.g., BNPL, Digital Wallet, or Card).
Completion: The customer completes the checkout process securely within the APM's environment.
Confirmation: Upon successful capture, the customer receives an immediate on-screen notification confirming the payment.

4. Merchant Notified of Final Status
Once a payment is successfully processed, the merchant is notified through three distinct channels to ensure records are kept up to date.
Email Notification: The email address of the user logged in when generating the link will receive a confirmation email stating the payment has been completed. This email matches the whitelabeling style configured for the customer-facing emails.
Dashboard Update: The Get-Paid listing page in the UPP, which tracks all generated links, will automatically update the status of the specific link to "Paid."
API Webhook: For integrations using the API, a webhook is triggered regarding the underlying APM payment. This payload includes a reference to the payment link ID, allowing you to programmatically reconcile the payment with the original hosted session.


Last updated