Skip to main content
Every time a customer completes a payment through a Payment Link URL, Singapay creates a Payment Link History record. This API lets you list, filter, and inspect those records for reconciliation, reporting, and customer support.

Per-payment records

Every payment through a link creates its own history entry with status, amount, and method.

Full fee breakdown

Each record shows vendor fee, platform margin, and net amount received.

Filterable & searchable

Query by reference number, method, status, amount, or date range.

A Payment Link is the parent — the reusable URL and its configuration. Each time a customer pays through it, a Payment Link History child record is created.
Example: Payment Link https://singapay.com/b2b/INV-2024-001
HistoryAmountMethodDate
#1IDR 500,000VA BRIJan 1
#2IDR 500,000QRISJan 2
#3IDR 500,000GoPayJan 3
One Payment Link → multiple independent history records.

Transaction lifecycle

1

Customer opens the link

Customer accesses the Payment Link URL and views the payment page with item details.
2

Selects a payment method

Customer chooses from the available methods configured for that link (VA, QRIS, or E-Wallet).
3

History record created

A Payment Link History record is created immediately with status pending.
4

Customer completes payment

Customer pays via the selected method. The bank or payment provider sends a notification to Singapay.
5

Processing and reconciliation

Singapay validates the payment and reconciles the transaction. Status updates to paid.
6

Settlement

Funds are settled to your account (bank or Singapay Balance) based on your configured settlement method.

Payment status

StatusDescription
pendingHistory record created, awaiting payment from customer.
paidPayment confirmed and reconciled by Singapay.
settledFunds transferred to your account.

Important notes

If customer detail collection is enabled on the Payment Link, name, email, and phone are captured and stored in each history record.
Every history record includes the payment method used, vendor fee, platform margin, and net amount received — ready for accounting reconciliation.
For QRIS payments, additional MDR (Merchant Discount Rate) information is recorded in the history entry alongside standard fields.
History records are retained for 1 year. Data older than 1 year is archived and may not be accessible via the API.

Available endpoints

List Payment Link Histories

Paginated list of history records for an account with full filter support.

Show Payment Link History

Retrieve a single history record by ID.
All endpoints require authentication. See Authentication.