Quick Answer
Integrate WiPay into a mobile app by sending each payment through your own backend server, loading WiPay’s hosted checkout page in a secure WebView, and confirming the result on the server with WiPay’s verification hash before you mark an order as paid.
WiPay has no official mobile SDK, and neither do Powertranz or Republic EPay, so every major Trinidad gateway uses this same hosted-page pattern. Plan for a documented 3.50% plus USD 0.25 fee per WiPay transaction, budget roughly TTD 10,000 to 25,000 for a secure custom integration, and start any bank merchant account application in week one, because approvals take weeks, not days.
How does WiPay work inside a mobile app?
WiPay is a payment aggregator that processes cards in Trinidad and Tobago dollars, and also in Jamaican, Barbadian, Guyanese, and East Caribbean dollars, with US dollar support for cross-border sales. The important detail for app builders is that WiPay does not publish an official mobile SDK for iOS, Android, Flutter, or React Native. It offers two web-style interfaces instead.
The first is the WiPay account API, used to manage the account, pull transaction history, and handle saved-card flows. It uses OAuth 2.0 bearer tokens: an access token expires after twelve hours, and the refresh token stays valid for six more hours after that. If your backend does not refresh tokens before they lapse, payments start failing with 401 errors at the worst possible moment. The second is the Payments API, which does the actual checkout. Your server sends the order details (account number, country, currency, order ID, total, and a response URL), and WiPay returns a hosted payment page where the customer enters their card. Your app never touches the card number.
How much does WiPay cost, and how fast do you get paid?
WiPay’s published pricing for Trinidad and Tobago is a fixed model. The Basic Free plan has no setup or monthly fee and charges 3.50% plus USD 0.25 on every local or international card transaction. The paid Business Plus plan costs about TTD 139 (USD 19.99) per month and lowers the percentage to 3.00%, still with the USD 0.25 fixed fee. Marketing pages sometimes quote a wider 2.5% to 4.5% range, so get your actual rate confirmed in writing when your account is approved.
You can also decide who pays the fee. The fee_structure setting in the payment request accepts merchant_absorb (the fee comes out of your settlement), customer_pay (the fee is added to the checkout total), or split (shared equally).
Settlement is the part that surprises people. Money lands in your WiPay wallet, and you request a withdrawal manually. A withdrawal to a local Trinidad bank account typically takes five to seven business days and costs TTD 5. A USD wire costs USD 11 (or TTD 65 plus USD 1). If cash flow matters to your business, that delay belongs in your planning from day one.
Which other payment gateways can a Trinidad app use?
WiPay is the fastest to get started with, but it is not the only option. Bank-linked gateways usually offer lower fees and faster settlement, at the price of a much heavier approval process.
| Gateway | How it integrates | Fees | Settlement and approval | Best for |
|---|---|---|---|---|
| WiPay | REST API and hosted payment page | 3.50% + USD 0.25 (Basic), 3.00% + USD 0.25 (Business Plus) | Quick approval, manual withdrawal, 5-7 business days to bank | Startups and small businesses |
| Powertranz (formerly First Atlantic Commerce) | Direct REST API, hosted page, tokenization, 3D Secure 2.x | Bank acquiring rates, typically 2.5% to 3.5%, plus gateway and monthly fees | 1-2 business days once live, approval can take several weeks | Larger e-commerce platforms and marketplaces |
| First Citizens easyBiz | Hosted storefront, payment links, social media buttons | Standard merchant acquiring fees | Reconciled to your First Citizens account within about 48 business hours, approval can take several weeks | SMEs that want a ready-made storefront |
| Republic Bank EPay | Hosted processing and payment links | Standard local acquiring fees | Advertised setup in as little as 4 days, expect longer in practice | Independent retailers and service providers |
| Endcash (Republic Bank) | Digital wallet, Endcash.Me links, in-store QR codes | No setup or monthly fee, TTD 0.50 per customer payment received | Immediate wallet settlement, with statutory transaction limits | Micro-merchants and small retail |
Fees and approval times change, so treat this table as a starting point and confirm current terms with each provider.
Why does merchant account approval take so long in Trinidad?
Getting a bank merchant account is the most common reason a Trinidad app launches late. Aggregators like WiPay can approve you quickly on basic identity checks. A bank cannot. Under anti-money laundering rules, a limited liability company normally has to provide its Certificate of Incorporation, Annual Return, Articles of Incorporation, and notices of directors, secretary, and address, plus two forms of ID and a recent utility bill for every director. Delays getting BIR and VAT clearance, on top of the bank’s own risk review, turn a process advertised in days into weeks or months.
The fix is simple: begin the paperwork at project kickoff, not after the app is built. Our mobile app timeline guide for Trinidad shows how much schedule this one task can eat.
What is the standard way to integrate a gateway into a Trinidad app?
Because WiPay and Powertranz do not ship native SDKs, the standard pattern in 2026 is the hosted payment page loaded inside a WebView. It works the same in Flutter, React Native, or native Swift and Kotlin:
- Start the payment on your server. The app tells your backend what the customer is buying. The backend builds the payment request and sends it to the gateway.
- Show the hosted checkout. The gateway returns a checkout URL. The app opens it in a WebView (WKWebView on iOS, WebView on Android) so the customer types their card details on the gateway’s own domain.
- Catch the redirect. When payment succeeds or fails, the gateway sends the WebView to your response URL. The app watches for that address, closes the WebView, and passes the returned parameters to your backend.
Both frameworks have mature WebView packages (react-native-webview and webview_flutter). If you are still deciding between them, read our comparison of Flutter vs React Native for Caribbean apps.
How do you verify that a payment is real?
Never treat the redirect back into the app as proof of payment. Anyone with a modified copy of your app can fake it. Confirm every payment on your server before you fulfil the order:
- Check the verification hash. For successful WiPay transactions the response includes an MD5 hash built from the transaction ID, the original total (exactly two decimal places), and your secret API key. Your backend recalculates it and compares. Powertranz uses the stronger HMAC-SHA256 with a shared secret.
- Keep the secret off the device. If your API key ships inside the app, attackers can forge valid hashes.
- Make it idempotent. Customers close apps mid-payment and networks send duplicate callbacks. Query the gateway’s transactions endpoint by transaction ID before you update an order, so an order is never fulfilled twice or marked paid from a stale callback.
What goes wrong most often when integrating WiPay or Powertranz?
Three problems come up again and again in developer forums and GitHub issues:
- 3D Secure fails in the WebView. The customer’s bank sends an SMS one-time password, but the bank’s page needs storage access and cross-origin features that a locked-down WebView blocks. The customer sees a blank screen and abandons the cart. Configure the WebView to allow DOM storage and mixed content, and handle custom URL schemes.
- The sandbox does not match production. WiPay’s test environment uses static credentials and turns off transaction history and reporting, so you cannot fully test reconciliation, webhook checks, or refunds until you go live. Plan a careful live test with small real payments.
- Token refresh fails silently. Missed OAuth refreshes cause sudden 401 errors during busy periods. Build the refresh job early and monitor it.
What do PCI DSS 4.0.1 and the Central Bank mean for your app?
Two rules shape how you build. First, PCI DSS 4.0.1 tightened the requirements for businesses that embed card forms or iframes on their own pages, including strict inventories of every script that runs and monitoring for tampering. Those controls are expensive for most Trinidad SMEs. A full redirect to the gateway’s hosted page, where the customer leaves your domain to enter card details, is still the safest and cheapest way to stay compliant.
Second, the Central Bank of Trinidad and Tobago regulates electronic money issuers (the companies behind digital wallets). Wallet accounts carry monthly limits: TTD 100,000 for micro-enterprises and TTD 200,000 for small and medium enterprises. If your sales pass the cap, the wallet provider must reject further transactions, so your app should show a clear message instead of a generic error.
Can you add Google Pay and Apple Pay?
Yes, but a wallet button does not replace a gateway. First Citizens Bank launched Google Pay for its Visa debit and credit cards in December 2025 and has said Apple Pay is being prepared for later in 2026. Republic Bank advertises Apple Pay, Samsung Pay, and Google Pay for its Mastercard products. Apple Pay coverage across all local banks is still uneven, so confirm the current status before you promise it to customers. A wallet only produces an encrypted payment token, and your gateway must be able to accept and process that token. Show the native wallet button next to the standard card option, and send the token to your backend for the gateway.
How much does payment integration cost in TTD?
A WooCommerce or WordPress plugin for WiPay on a website is close to free and quick to configure. A custom mobile app is different: a secure integration with a backend, webhook checks, state handling, and edge-case testing (duplicate callbacks, failed 3D Secure) typically takes 30 to 60 development hours. At 2026 Trinidad senior developer rates, budget roughly TTD 10,000 to 25,000 for a well-tested integration, separate from gateway fees. In a full app budget this sits as one line item, which our mobile app cost guide for Trinidad breaks down by tier. If you want us to build it, see our mobile app development services in Trinidad.
Sources: fees, settlement, and integration details reflect the provider documentation available in 2026. See the WiPay developer documentation, WiPay support pages, the Powertranz hosted payment page guide, the PCI Security Standards Council, and the Central Bank of Trinidad and Tobago draft payment systems and e-money regulations (March 2026). Terms change, so confirm current rates and requirements with each provider before you commit.
Frequently asked questions
Does WiPay have an official SDK for Flutter or React Native?
No. As of 2026 WiPay publishes a web-based REST interface but no official mobile SDK for iOS, Android, Flutter, or React Native. Mobile apps connect through a backend server and a hosted checkout page loaded in a WebView.
How much does WiPay charge per transaction in Trinidad and Tobago?
WiPay documents a Basic Free plan at 3.50% plus USD 0.25 per transaction, with no setup or monthly fee. A paid Business Plus plan at about TTD 139 per month lowers the rate to 3.00% plus USD 0.25. Confirm your exact rate in writing before you sign up.
How long does it take to receive money from WiPay?
Funds sit in your WiPay wallet until you request a withdrawal. A withdrawal to a local Trinidad bank account typically takes five to seven business days and carries a fee of TTD 5.
How long does a bank merchant account take to approve in Trinidad?
Banks advertise days, but real approvals often stretch to several weeks because of company documents, BIR and VAT clearance, and bank underwriting. Start the application in the first week of the project.
How much does it cost to add payments to a custom mobile app in Trinidad?
A secure custom integration usually takes 30 to 60 development hours, which puts the budget at roughly TTD 10,000 to 25,000, not counting gateway fees or the cost of the rest of the app.