SeoulCommerce Payment Gateway for TossPayments

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

1. 🎯 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
2. 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.
3. Activate the plugin through the 'Plugins' screen in WordPress.
4. Go to WooCommerce > Settings > Payments and configure TossPayments.
5. Enter your TossPayments API keys (Client Key and Secret Key) from your TossPayments dashboard.
6. Enable test mode for testing or disable for live payments.
7. Save changes and start accepting payments!

Configuration

1. First, create your TossPayments merchant account (required): https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd
2. Navigate to WooCommerce > Settings > Payments
3. Click on "TossPayments" to configure
4. You'll see a prominent signup notice at the top with the special link
5. After signing up, get your API keys from TossPayments dashboard
6. Enter your TossPayments API credentials:
7. Test Client Key (for testing)
8. Test Secret Key (for testing)
9. Live Client Key (for production)
10. Live Secret Key (for production)
11. Configure other settings as needed
12. 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:

1. Run npm install
2. Run npm run build

External services This plugin relies on TossPayments services to process payments.

1. TossPayments JavaScript SDK (https://js.tosspayments.com/v2/standard)
2. Used to open the payment window during checkout.
3. Data sent when customer starts payment: order ID, order name, amount, customer name/email/phone.
4. TossPayments Payments API (https://api.tosspayments.com/v1)
5. Used by the server to confirm/cancel payments and process refunds.
6. Data sent from server: payment key, order ID, amount, refund reason (for cancellation/refund).
7. TossPayments merchant onboarding page (https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd)
8. 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

1. TossPayments settings page in WooCommerce
2. Checkout page with TossPayments payment method
3. TossPayments payment window
4. Order details with payment information
5. Refund interface in order management

1.0.0 - 2025-12-05

• Initial release
• TossPayments v2 API integration with latest standards
• Card payment support (credit cards and debit cards)
• Full and partial refund support
• WooCommerce checkout blocks compatibility
• Traditional checkout support
• Test mode for safe testing
• Webhook support for real-time payment updates
• Secure payment processing with proper authentication
• Admin order refund functionality
• Korean phone number formatting
• Order ID sanitization for API compatibility
• Comprehensive error handling and logging
• WordPress coding standards compliant
• HPOS (High-Performance Order Storage) compatible
• Responsive design for mobile devices