E-Wallet (Money In)

E-Wallet (Money In) on Singapay Payment Gateway

E-Wallet Native is a money-in payment method that allows your customers to pay directly using their e-wallet apps such as ShopeePay and Dana. When a checkout is created, the customer receives a redirect URL to authorize and complete the payment within their e-wallet app.

Note: This is a Money In operation — funds are transferred from the customer's e-wallet to your SingaPay Payment Gateway account. For Money Out (top-up to customer e-wallets), see the E-Wallet Top Up (Money Out) section.

E-Wallet Payment Flow

Transaction Status Lifecycle

openCheckout created, waiting for customer to authorize and complete payment via e-wallet app. Checkout URL is active.
successPayment completed successfully. Funds received from the customer.
expiredCheckout link has expired. Auto-computed when the expired_at timestamp has passed while status is still open.
canceledTransaction was canceled before payment was completed.
failedPayment attempt failed due to an error during processing.

Supported E-Wallet Vendors

ShopeePay

EWALLET_SHOPEEPAY

Supports web redirect and app deep link

Dana

EWALLET_DANA

Support web redirect

OVO

EWALLET_OVO

Support push to pay

Available Operations

• Create Checkout: Create a new e-wallet payment checkout order with a redirect URL for the customer.
• List Transactions: Retrieve a paginated list of all e-wallet transactions for an account with filters.
• Show Transaction: Get detailed information about a specific e-wallet transaction.
• Inquiry Status: Check and sync the latest payment status from the e-wallet vendor. Can trigger state changes.
• Delete: Delete an e-wallet transaction (only allowed for transactions with status "open").

Important Notes

• Checkout Expiration: By default, checkout URLs expire after 30 minutes. You can set a custom expiration using the expired_at parameter.
• Auto-Expire Status: The status_computed field automatically shows "expired" when an open transaction's expired_at has passed, even if the raw status is still "open".
• Two Redirect URLs: checkout_url is for web browser redirect, while checkout_url_app is the deep link to open the e-wallet app directly (if supported by the vendor).
• Fee Breakdown: Each transaction shows vendor_fee, merchant_fee, and net_amount for transparent fee tracking.
• Settlement Tracking: Monitor reconciliation and settlement status via has_recon and has_settle fields.
• Delete Restriction: Only transactions with status "open" can be deleted. Paid/settled transactions cannot be deleted.
• Transaction History: Records from the last 1 year are available via the API. Older records are archived.