Integration Guide

This guide walks you through the complete integration process with the Pine Labs API. Follow these 7 steps to start processing transactions.

Starting a New Integration?

We recommend the Dynamic Product Catalog for new integrations. It provides structured product fields, built-in validation, fulfillment mapping, and real-time updates via webhooks.

The step-by-step guide below uses the legacy Product Listing API, which is maintained for existing integrations. See the Migration Guide if you are migrating from legacy to the new catalog.

Integration Flow

Step	Description	Link
1	Get available products and their codes	Product Listing
2	Select JomPAY billers, data plans, or PTPTN accounts	JomPAY Billers / Sub Products
3	Check if the network/service is available	Network Status
4	Retrieve outstanding bill amounts (Beta)	Bill Presentment
5	Process the actual payment	Make Payment
6	Verify final transaction status	Make Payment
7	Reconcile transactions	Reconciliation

Prerequisites

Before you begin integration:

1. Create an account — Sign up on staging for testing or request production access.
2. Get API credentials — Generate your API key and HMAC secret from Developer > API Keys in the Dashboard.
3. Authenticate — Set up API Key authentication for API requests.
4. Set up callbacks — Configure your callback URL for transaction updates.

Best Practices

Idempotency

Always use the same refid when retrying a failed transaction. This prevents duplicate charges.

Check Network Status

Before processing payments, always check the network status to ensure the service is available.

Complete Example

See a complete end-to-end walkthrough showing every API call for a Digi Prepaid reload, from authentication to reconciliation.

Support

Need help with integration?

• Error Codes Reference — Understand transaction status codes
• Postman Collection — Test API endpoints interactively
• AI Customer Support — Get assistance via AI-powered support