SeoulCommerce Payment Gateway for TossPayments integrates TossPayments card payment functionality into your WooCommerce store. This plugin uses the TossPayments version 2 API/SDK and is compatible with WooCommerce checkout blocks.
Note: This plugin is developed by
SeoulCommerce.com
Features
- Card payment support via TossPayments v2 API
- Full WooCommerce checkout blocks compatibility
- Test mode for sandbox testing
- Secure payment processing
- Refund support
- Webhook support for payment status updates
- Comprehensive backend configuration
- WordPress coding standards compliant
Requirements
- WordPress 6.0 or higher
- WooCommerce 8.0 or higher
- PHP 7.4 or higher
- A TossPayments merchant account (required)
Installation
- 🎯 IMPORTANT: A TossPayments merchant account is required before using this plugin.
Use the official onboarding link:
https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd
- Upload the plugin files to the
/wp-content/plugins/seoulcommerce-payment-gateway-for-tosspayments directory, or install the plugin through the WordPress plugins screen directly.
- Activate the plugin through the 'Plugins' screen in WordPress.
- Go to WooCommerce > Settings > Payments and configure TossPayments.
- Enter your TossPayments API keys (Client Key and Secret Key) from your TossPayments dashboard.
- Enable test mode for testing or disable for live payments.
- Save changes and start accepting payments!
Configuration
- First, create your TossPayments merchant account (required):
https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd
- Navigate to WooCommerce > Settings > Payments
- Click on "TossPayments" to configure
- You'll see a prominent signup notice at the top with the special link
- After signing up, get your API keys from TossPayments dashboard
- Enter your TossPayments API credentials:
- Test Client Key (for testing)
- Test Secret Key (for testing)
- Live Client Key (for production)
- Live Secret Key (for production)
- Configure other settings as needed
- Save changes
API Keys
STEP 1: Sign up with our special affiliate link first (get special merchant rates!):
https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd
STEP 2: After signup, get your API keys from TossPayments developer dashboard:
https://developers.tosspayments.com/
Support
For support, please visit:
https://github.com/seoulcommerce/seoulcommerce-payment-gateway-for-tosspayments/issues
Source code for generated assets
This plugin includes generated build assets for WooCommerce Blocks:
Build steps:
- Run
npm install
- Run
npm run build
External services
This plugin relies on TossPayments services to process payments.
- TossPayments JavaScript SDK (
https://js.tosspayments.com/v2/standard)
- Used to open the payment window during checkout.
- Data sent when customer starts payment: order ID, order name, amount, customer name/email/phone.
- TossPayments Payments API (
https://api.tosspayments.com/v1)
- Used by the server to confirm/cancel payments and process refunds.
- Data sent from server: payment key, order ID, amount, refund reason (for cancellation/refund).
- TossPayments merchant onboarding page (
https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd)
- Used only when merchant/admin clicks signup/onboarding links in plugin settings/banner.
Service provider: TossPayments.
Frequently Asked Questions
How do I get TossPayments API keys?
IMPORTANT: First sign up using our special affiliate link to get preferential merchant rates:
https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd
After signup, get your API keys from the TossPayments developer dashboard:
https://developers.tosspayments.com/
Does this plugin support test mode?
Yes, the plugin includes full test mode support. Enable test mode in the settings to use test API keys.
Is this plugin compatible with WooCommerce checkout blocks?
Yes, this plugin is fully compatible with WooCommerce checkout blocks and follows the latest checkout blocks standards.
Can I process refunds?
Yes, the plugin supports full and partial refunds through the WooCommerce order management interface. Partial cancellations keep the order in a paid status. Full cancellations set the order to refunded. Version 1.0.2 incorrectly mapped both CANCELED and PARTIAL_CANCELED to cancelled; use 1.0.3 or later.
Which WordPress / WooCommerce / PHP versions are supported?
Minimum: WordPress 6.0, WooCommerce 8.0, PHP 7.4. GitHub Actions tests PHP 7.4 and 8.3. HPOS may be enabled or disabled. WordPress 7.x / WooCommerce 11.x are not in the automated matrix; see the GitHub README compatibility section.
How are cancelled orders protected from a late paid webhook?
Orders in cancelled, refunded, failed, or trash are never restored to paid. The plugin re-queries TossPayments instead of trusting the webhook body. If TossPayments still reports DONE for an unpaid cancelled order, the plugin leaves WooCommerce unchanged and attempts to cancel that capture.
Are TossPayments idempotency keys used?
Yes. Confirm and cancel/refund requests send an Idempotency-Key header. If confirm times out, the plugin looks up GET /v1/payments/{paymentKey} before treating the payment as failed.
Where are secret keys stored?
By default in the WooCommerce settings option (wp_options), which is included in database backups. They are not stored in order meta or sent to the browser. You can instead set SEOULCOMMERCE_TPG_SECRET_KEY_TEST and SEOULCOMMERCE_TPG_SECRET_KEY_LIVE in wp-config.php or as environment variables. Debug logs redact secret-key patterns and never log the Authorization header.
Screenshots
- TossPayments settings page in WooCommerce
- Checkout page with TossPayments payment method
- TossPayments payment window
- Order details with payment information
- Refund interface in order management