# Billplz integrations: bills and collections

> Create a bill, create a collection and create a payment order in Billplz, and start a workflow when Billplz sends “Bill payment completed”.

**Canonical page:** https://tray.ai/connectors/billplz-integrations/
**Categories:** Finance
**Connects through:** HTTP Connector

## Overview

Billplz is a Malaysian payment gateway for collecting payments through bills and FPX online banking, and for sending payouts through payment orders. Tray.ai connects to Billplz through the HTTP Connector, so your workflows can call the Billplz API alongside the rest of your stack.

## Use cases

### Bills

Read, create, and delete bills in Billplz from any Tray.ai workflow. The Billplz API covers calls such as create a bill and get a bill.

- Create a bill
- Get a bill
- Delete a bill

### Collections

Read, create, and update collections in Billplz from any Tray.ai workflow. The Billplz API covers calls such as list collections and get a collection.

- List collections
- Get a collection
- Create a collection

### Payment orders

Read and create payment orders in Billplz from any Tray.ai workflow. The Billplz API covers calls such as create a payment order and get a payment order.

- Create a payment order
- Get a payment order
- Get the payment order limit

### Payment order collections

Read and create payment order collections in Billplz from any Tray.ai workflow. The Billplz API covers calls such as create a payment order collection and get a payment order collection.

- Create a payment order collection
- Get a payment order collection

### Agreements

Read, create, and delete agreements in Billplz from any Tray.ai workflow. The Billplz API covers calls such as create an agreement and get an agreement.

- Create an agreement
- Get an agreement
- Delete an agreement

### Billplz events

Start a Tray.ai workflow the moment something happens in Billplz. Billplz sends events such as bill payment completed and payment order completed to a Tray.ai webhook trigger.

- Bill payment completed
- Payment order completed

## Challenges Tray.ai solves

### Keeping Billplz credentials out of logs

A raw API call usually means pasting a key or token into the request, where it ends up in step inputs, logs, and screenshots.

**How Tray.ai helps:** Store Billplz credentials once as a Tray.ai authentication and reference them from the HTTP Connector. Tray.ai masks authentication values in logs, so the secret never shows up in a step's input or output.

### Going from the Billplz API docs to a working call

Translating an example request from API docs into a workflow step means copying the method, URL, headers, and body by hand.

**How Tray.ai helps:** Paste a cURL example from the Billplz API docs into the HTTP Connector and Tray.ai fills in the method, URL, headers, and body for you.

### Handling files and non-JSON responses

Not every API answers in JSON. Some return XML, files, or binary data, or expect a multipart upload.

**How Tray.ai helps:** The HTTP Connector parses JSON and XML responses, returns files you can pass to the next step, and sends multipart form data for uploads.

## Frequently asked questions

### Does Tray.ai connect to Billplz?

Yes. Tray.ai connects to Billplz through the HTTP Connector, which calls the Billplz API directly. Any call the Billplz API documents can run as a step in a Tray.ai workflow.

### How does Tray.ai authenticate with Billplz?

The Billplz API uses basic authentication. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

### Can I get a dedicated Billplz connector?

Billplz runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated Billplz connector from the Billplz API.

## Learn more

- Intelligent Integration: https://tray.ai/platform/intelligent-ipaas/
- Merlin Agent Builder: https://tray.ai/platform/merlin-agent-builder/
- Agent Gateway for MCP: https://tray.ai/platform/agent-gateway/
- Book a demo: https://tray.ai/contact/