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
🎯 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.
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
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/
For support, please visit:
https://github.com/seoulcommerce/seoulcommerce-payment-gateway-for-tosspayments/issues
This plugin includes generated build assets for WooCommerce Blocks:
build/blocks/frontend.jssrc/blocks/frontend.jswebpack.config.jsBuild steps:
npm installnpm run buildThis plugin relies on TossPayments services to process payments.
https://js.tosspayments.com/v2/standard)
https://api.tosspayments.com/v1)
https://onboarding.tosspayments.com/registration/business-registration-number?utm_source=seoulwd&utm_medium=hosting&agencyCode=seoulwd)
Service provider: TossPayments.
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/
Yes, the plugin includes full test mode support. Enable test mode in the settings to use test API keys.
Yes, this plugin is fully compatible with WooCommerce checkout blocks and follows the latest checkout blocks standards.
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.
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.
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.
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.
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.