paddle-billing-history

Retrieve and format Paddle API customer transactions with pagination and currency conversion.

4|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/PaddleHQ/paddle-agent-skills --skill paddle-billing-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paddle-billing-history
Source: https://github.com/PaddleHQ/paddle-agent-skills/tree/main/providers/cursor/plugin/skills/billing-history
Command: npx skills add https://github.com/PaddleHQ/paddle-agent-skills --skill paddle-billing-history

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the complexity of building a secure, customer-facing billing history UI in Next.js by handling the mandatory Paddle API filtering, pagination, and currency formatting logic.

Core Features & Use Cases

  • Secure Transaction Listing: Fetches transaction data scoped strictly to the authenticated user via a server-side customer ID lookup.
  • Robust Formatting: Handles currency conversion from lowest-unit integers to locale-aware strings, including special cases for zero-decimal currencies like JPY and KRW.
  • Use Case: Use this when building a customer dashboard where users need to view their past invoices, check payment statuses, and download receipts without leaving your application.

Quick Start

Use the paddle-billing-history skill to implement a paginated transaction list in my Next.js account page.

Frequently Asked Questions about paddle-billing-history

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display authenticated user billing history in a Next.js SaaS application?

To display authenticated user billing history in Next.js, this skill retrieves customer transaction data from the Paddle API, handling server-side customer ID lookups to ensure strict data isolation. It formats transactions with locale-aware currency conversion for global markets.

How does Paddle API currency conversion handle zero-decimal currencies like JPY and KRW?

Paddle API currency conversion for zero-decimal currencies like JPY and KRW involves formatting lowest-unit integers into locale-aware strings. This skill automatically handles these special cases alongside standard currencies to ensure accurate global transaction displays.

Do I need a mirrored customer database to fetch Paddle transaction history securely?

Yes, a mirrored customer database is required to fetch Paddle transaction history securely. This integration ensures data isolation by performing a server-side customer ID lookup, scoping the retrieved transaction data strictly to the authenticated user.

What is the best way to implement cursor-based pagination for Paddle transactions?

The best way to implement cursor-based pagination for Paddle transactions is using this skill's built-in logic, which manages API pagination requests and status filtering. It allows users to seamlessly browse past invoices and check payment statuses.

Can I filter Paddle billing history by transaction status in my customer dashboard?

Yes, you can filter Paddle billing history by transaction status in your customer dashboard. This skill supports status filtering natively, allowing users to view specific past invoices, check payment statuses, and download receipts.

Does Paddle billing history support downloading receipts without leaving my web application?

Paddle billing history supports downloading receipts without leaving your web application by retrieving and formatting transaction data directly from the Paddle API. This allows users to manage past invoices and receipts entirely within your customer dashboard.