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:

Generated file: build/blocks/frontend.js
Human-readable source: src/blocks/frontend.js
Build config: webpack.config.js
Public source repository: https://github.com/seoulcommerce/seoulcommerce-payment-gateway-for-tosspayments

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.

Terms: https://pages.tosspayments.com/terms/user
Privacy: https://pages.tosspayments.com/terms/privacy/consent1/en/

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.

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