VA Transaction
VA Transaction on Singapay Payment Gateway
VA Transaction represents each payment made to a Virtual Account. When a customer pays to a Virtual Account number, a new VA Transaction record is created. Use this API to track, monitor, and reconcile all payments received through your Virtual Accounts.
Relationship with Virtual Account
Virtual Account (Parent) → The reusable payment instrument with a unique VA number
VA Transaction (Child) → Individual payment records linked to a Virtual Account
Example:
• VA Number: 8890-1234-5678 (Permanent VA for Customer A)
• VA Transaction #1: IDR 500,000 - Paid on Jan 1
• VA Transaction #2: IDR 750,000 - Paid on Jan 15
• VA Transaction #3: IDR 300,000 - Paid on Feb 1
→ One VA has multiple transactions over time
Transaction Lifecycle
- 1Payment Received: Customer transfers funds to the VA number. Bank notifies SingaPay.
- 2Transaction Created: VA Transaction record created with status "unpaid".
- 3Processing: System validates amount, checks for duplicates, and verifies payment details.
- 4Reconciliation: Finance team reconciles the transaction. Status changes to "paid".
- 5Settlement: Funds are settled to your account (bank or SingaPay Balance) based on your settlement method.
Important Notes
- • Query by VA Number: You can retrieve all transactions for a specific Virtual Account using the VA number.
- • Status Tracking: Monitor transaction status from "unpaid" to "paid" to "settled".
- • Fee Breakdown: Each transaction shows vendor fee, platform margin, and net amount received.
- • Settlement Information: Track when funds were reconciled and settled to your account.
- • Webhook Notifications: Receive real-time updates when transaction status changes (if webhooks are configured).
- • Transaction History: Records are retained for 1 year. Data older than 1 year is archived.