Payment Portals
WifiCone supports multiple payment methods simultaneously. Customers can pay with coins, bills, or any enabled e-wallet on the same device.
Supported Payment Methods
| Method | Type | Notes |
|---|---|---|
| Coin Acceptor | Hardware | GPIO-based; configurable pulses per peso |
| Bill Acceptor | Hardware | GPIO-based; maps pulse counts to denominations |
| GCash | E-wallet QR | Customers scan a QR code on the captive portal |
| Maya | E-wallet QR | Customers scan a QR code on the captive portal |
| Coins.ph | E-wallet QR | Customers scan a QR code on the captive portal |
Coin Acceptor
Go to Payment Portals → Coin Acceptor.
| Setting | Description |
|---|---|
| Enable | Toggle coin acceptor on/off |
| GPIO Pin | The GPIO pin number the coin acceptor signal wire connects to |
| Pulses per Peso | How many pulses the acceptor sends per ₱1 coin (check your acceptor's spec sheet) |
| Debounce (ms) | Delay in milliseconds to ignore noise after a valid pulse (default: 50ms) |
Common Pulse Values
| Coin | Typical Pulses |
|---|---|
| ₱1 | 1 pulse |
| ₱5 | 5 pulses |
| ₱10 | 10 pulses |
| ₱20 | 20 pulses |
Always verify with your specific acceptor model's documentation.
Bill Acceptor
Go to Payment Portals → Bill Acceptor.
| Setting | Description |
|---|---|
| Enable | Toggle bill acceptor on/off |
| GPIO Pin | The GPIO pin the bill acceptor signal wire connects to |
| Pulse Map | Maps pulse counts to denominations (e.g., 2 pulses = ₱20) |
Default Pulse Map
| Pulses | Denomination |
|---|---|
| 2 | ₱20 |
| 3 | ₱50 |
| 4 | ₱100 |
| 5 | ₱200 |
| 6 | ₱500 |
You can adjust these values to match your bill acceptor's behavior.
GCash
Go to Payment Portals → GCash.
- Toggle Enable GCash.
- Upload your GCash QR code image (PNG or JPG).
- Enter your Account Name (shown to customers below the QR).
- Enter your GCash Number (shown as reference for customers).
- Click Save.
When a customer selects GCash on the captive portal, the QR code is displayed full-screen for them to scan with their GCash app.
Maya (PayMaya)
Go to Payment Portals → Maya.
Same setup as GCash — upload your Maya QR code image, enter account name and number, and save.
Coins.ph
Go to Payment Portals → Coins.ph.
Same setup — upload your Coins.ph QR code, enter account details, and save.
Webhook (Event Notifications)
WifiCone can POST a JSON payload to an external URL when payment events occur.
Go to Payment Portals → Webhook.
| Setting | Description |
|---|---|
| Webhook URL | Your endpoint URL that receives the POST |
| Events | sale.created, session.started, session.expired |
Example Payload (sale.created)
{
"event": "sale.created",
"amount": 10,
"portal": "coin",
"voucher_code": null,
"timestamp": "2025-06-13T08:00:00Z"
}
Connected Devices
The Connected Devices table at the bottom of Payment Portals shows all currently connected hardware (coin acceptors, bill acceptors, printers) and their status.
Tips
- You can enable all payment methods simultaneously — the captive portal shows all active options to the customer.
- For coin acceptors: if coins are not registering, check the Debounce setting — a value too low causes double-counting; too high misses fast inserts.
- E-wallet QR codes do not auto-verify payment — the customer is expected to pay and then confirm on the portal. For automated verification, a custom webhook integration is required.