Blog Posts

Gift Certificate Module for Oqtane

1/1/2026 Oqtane

Gift certificates for Oqtane, powered by PayPal and PDFs.

GIBS.Module.GiftCert is an Oqtane module that collects gift certificate details, processes payment via PayPal, sends email notifications, and generates downloadable PDF certificates.

At a glance

PayPal Checkout

Sandbox + Production modes supported
PDF Certificates

Generated via PDFsharp + MigraDoc
Email Notifications

HTML email via MailKit / MimeKit
Admin Management

Track status, mark processed, generate PDF (after PAID)

Built for production Oqtane sites

Includes packaging notes for common startup issues caused by missing transitive dependencies.

Key features

Everything needed for a simple “purchase → pay → fulfill” gift certificate flow.

Customer purchase flow

Capture amount, recipient/sender info, notes, and mailing details.

PayPal integration

Create and capture orders server-side; store PayPal response details.

PDF generation

Generate a certificate PDF once payment is marked PAID.

Email notifications

Send purchase and update emails using MailKit/MimeKit (HTML).

Admin tools

Mark processed, review PayPal status/IDs, generate PDFs from admin UI.

Oqtane module packaging

Delivered as a NuGet package for Oqtane installation.

How it works

Customer enters gift certificate details and saves the request.
PayPal buttons load and the customer completes payment.
Server captures the order and persists PayPal response details.
Emails are sent to the purchaser and admins (configurable).
Admin generates the PDF and marks the certificate as processed.

Designed for fulfillment

Manage gift certificates from the admin UI and generate/download PDFs after payment confirmation.

Payment state

Visual indicator for PAID vs not paid

PDF generation

Available when state is PAID

Processed flag

Track fulfillment progress

Audit fields

Created/modified metadata in admin UI

Settings

Configure PayPal credentials, default values, PDF text/branding, and email behavior directly in Oqtane module settings.

PayPal

PayPalSandboxMode
Sandbox: Payee, Client ID, Client Secret
Production: Payee, OAuth Client ID/Secret

General

DefaultValue
ModuleInstructions
NumPerPage
FileFolder (PDF storage folder)

PDF & Email

PDF: banner/footer/watermark/logo/return address
Email: reply-to, notify, BCC, subject, instructions

Settings are managed through the Oqtane UI: open the page with the module and choose Settings.

Deploy safely

Oqtane scans module assemblies during startup. Missing transitive dependencies can prevent the site from starting (commonly seen as HTTP 500.30 on IIS).

Tip

Ensure transitive dependencies are included in your module package under lib/net9.0. For PayPal, this typically includes APIMatic.Core.dll (required by PayPalServerSDK).

Source / Docs Back to top

Install steps

Build the module in Release.
Create the .nupkg from the Package project.
Install the package into the Oqtane site.

Packaging uses Package/GIBS.Module.GiftCert.nuspec.

‹ Back to List