CartModules: TapPay Payment Gateway

Accept TapPay Payments in Your CS-Cart Store

Integrate TapPay — Taiwan's leading payment platform — directly into your CS-Cart or Multi-Vendor store. Support credit/debit cards, LINE Pay, JKOPay, Easy Wallet, AFTEE, Pi Wallet, Plus Pay, Samsung Pay, and Apple Pay through a secure hosted checkout flow.

Key Features

• Multiple Payment Methods — Credit/debit cards, LINE Pay, JKOPay, Easy Wallet, AFTEE, Pi Wallet, Plus Pay, Samsung Pay, Apple Pay
• Redirect-Based Flow — No sensitive data touches your server (PCI SAQ A compliant)
• Multi-Currency Support — TWD (Taiwan Dollar), JPY (Japanese Yen), MYR (Malaysian Ringgit)
• Automatic Order Updates — Transaction status verified via query API on customer return
• Sandbox/Production Toggle — Switch between test and live environments from the admin panel
• Configurable Order Statuses — Map TapPay statuses (Success, Failed) to any CS-Cart order status
• x-api-key Authentication — Secure API communication using TapPay's Partner Key
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• Integer Amount Handling — TWD and JPY amounts correctly sent without decimal places

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• TapPay merchant account with API credentials (Partner Key, Merchant ID)
• Store currency set to TWD, JPY, or MYR

Supported Countries

• Taiwan — Primary market (TWD)
• Japan — Supported (JPY)
• Malaysia — Supported (MYR)

How It Works

1. Customer selects TapPay at checkout and clicks "Place Order"
2. The addon creates a payment via the TapPay Pay by Prime API
3. Customer is redirected to the TapPay hosted payment page
4. Customer selects their preferred payment method and completes the payment
5. TapPay redirects the customer back to your store
6. The addon queries the transaction status and updates the order accordingly

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "TapPay Payment Gateway" as the processor
5. Enter your Partner Key and Merchant ID from the TapPay merchant portal
6. Configure order status mappings as desired
7. Save and test with sandbox mode before going live

Country & Currency

This addon is designed for merchants selling in Taiwan, Japan, and Malaysia. TapPay supports TWD (Taiwan Dollar), JPY (Japanese Yen), and MYR (Malaysian Ringgit). TWD and JPY amounts are handled as integers (no decimal places).