This is a Money Out operation. Each top-up debits funds from your Singapay Payment Gateway balance and credits the destination e-wallet account.
OVO
Top up OVO balance directly.
Dana
Transfer to Dana accounts.
ShopeePay
Fund ShopeePay wallets.
GoPay & more
GoPay and other supported providers.
Recommended flow
1
Trigger top-up
Call E-Wallet Top Up — Trigger Transfer with the e-wallet provider, the customer’s e-wallet phone number, and the amount. Singapay debits your balance and dispatches the top-up job to the provider. A
reference_number is returned to track the transaction.2
Inquiry status
Use E-Wallet Top Up — Inquiry Status with the
reference_number to verify the final outcome — especially for transactions that remain in pending state.Transaction status
Important notes
Destination account validation
Destination account validation
Trigger Transfer validates the destination e-wallet account. If the account isn’t found, the request fails with response code
SP117.Provider-specific limits
Provider-specific limits
Each e-wallet provider has its own minimum and maximum top-up limits. Make sure the amount is within the provider’s limits before you submit a transfer.
Signature required for transfers
Signature required for transfers
The Trigger Transfer endpoint requires additional
X-Signature and X-Timestamp headers using internal signing rules — separate from standard Bearer token auth. See Authentication for signing requirements.Reference number for tracking
Reference number for tracking
Store the
reference_number returned from the Trigger Transfer call. Use it with Inquiry Status to safely check the outcome and handle retries without creating duplicate top-ups.Pending status handling
Pending status handling
For transactions that return
pending, use Inquiry Status to refresh the status. If a vendor_reference_no exists on a pending record, Singapay will attempt to refresh the status from the provider — timeouts return response code SP005.Available endpoints
Trigger Transfer
Initiate the top-up and transfer funds from your Singapay balance to the e-wallet.
Inquiry Status
Query the current status of a top-up transaction by reference number.
All endpoints require
Authorization: Bearer <token> and X-PARTNER-ID on every request. The Trigger Transfer endpoint additionally requires X-Signature and X-Timestamp. See Authentication for details.