© 2026 Billplz Sdn Bhd

A Collection is the container that groups your bills — each Collection has its own payment method settings, Split Rules, and a unique Collection ID. You'll need that ID in API calls when creating bills, as every bill must be linked to a collection. This article shows you how to create a collection and retrieve its ID.

Before you begin

  • Your Billplz account must be verified and active.
  • If you're testing your integration, create a collection in your sandbox account first. See Create a sandbox account.

Step 1: Go to Collection

In the left navigation of your Billplz dashboard, click Collection.

Billplz Billing Dashboard - Main collections landing screen displaying currently active payment groups.

Step 2: Create a collection

Click Create Collection in the top right corner. Enter a name for this collection and click Submit.

Billplz Collections List - Navigating to the action header area to locate the blue "Create Collection" button.Billplz Collection Creation - Input modal to specify a custom collection title and review account credit reload rules.

Step 3: Copy your Collection ID

Your new collection appears in the list. The Collection ID is displayed below the collection name (e.g., hywrw83r). Click Copy to copy it to your clipboard.

Billplz Collection ID Retrieval - Clicking the copy button to instantly save the unique collection string identifier to the clipboard.

Use this Collection ID in your API calls when creating bills. Pass it as the collection_id parameter.

Common issues