Skip to main content
Toss Payments is a Korean payment service provider that helps businesses accept credit cards, bank transfers, virtual accounts, and local digital wallets. You can connect your Toss Payments merchant account to a Readdy project and ask AI to add a secure payment flow to your website. Once connected, Readdy can generate a Toss Payments Payment Widget for one-time payments in Korean won (KRW), confirm completed payments securely, and update the corresponding order in your connected database.
Toss Payments integration announcement and payment widget

​
Before You Start

This guide will walk you through connecting Toss Payments to your Readdy project. Before you begin, make sure you have the following ready:
  • An active Toss Payments merchant account.
  • An approved electronic payment services application. You can apply through Apply for Electronic Payments in Toss Payments. Your application must be approved before you can accept live payments.
  • A Readdy project connected to Readdy Backend or Supabase.
Once these are ready, let’s connect Toss Payments.

​
Get Your Toss Payments Keys

1

Open the Toss Payments Developer Center

Go to the Toss Payments Developer Center, log in to your merchant account, and open “API Keys”.
API Keys page in the Toss Payments Developer Center
2

Choose the Environment

Select the “Test” or “Live” environment at the top of the page.
Test payments simulate authorization and do not charge the payment method, even when you enter real payment information.
Test and live environment switcher in the Toss Payments Developer Center
3

Copy the Payment Widget Keys

Find Payment Widget integration keys (결제위젯 연동 키), then copy the Client Key and Secret Key from the same key pair.
Payment Widget Client Key and Secret Key in the Toss Payments Developer Center
You can view your Payment Widget integration keys only after applying for Toss Payments electronic payment services. Even test keys require an application. Before applying, you can use the following public test pair:clientKey = 'test_gck_docs_Ovk5rk1EwkEbP0W43n07xlzm'secretKey = 'test_gsk_docs_OaPz8L5KdmQXkzRz3y47BMw6'
Do not use individual API integration keys (API 개별 연동 키). Keys beginning with test_ck_, test_sk_, live_ck_, or live_sk_ are not supported by Readdy’s current Payment Widget integration.
Keys in different environments have different prefixes
The Client Key and Secret Key must:
  • Come from the same merchant ID.
  • Belong to the same Payment Widget key pair.
  • Both be test keys or both be live keys.
You can use a matching test pair while building and testing your website. Test payments do not create a real charge. Use a matching live pair when your Toss Payments contract and website are ready to accept real payments. For more information about the keys and Payment Widget, see the official Toss Payments Payment Widget guide.

​
Connect Toss Payments in Readdy

1

Open the Connects Panel

In the Readdy editor, click “Connects” at the top of the screen.
Connects button at the top of the Readdy editor
2

Select Toss Payments

Find Toss Payments in the Connects panel, then click “Connect”.
Toss Payments integration in the Connects panel
If your project does not have a connected database, Readdy asks you to connect Readdy Backend or Supabase first. Toss Payments uses the connected backend to create orders, keep the Secret Key secure, and confirm payments.
3

Enter Your Integration Keys

Paste the matching Widget Client Key and Widget Secret Key, then click “Connect”.
Widget Client Key and Widget Secret Key fields in Readdy
4

Confirm the Connection

Check that the panel displays “Connected” and masks both keys.
Toss Payments connected in Readdy with masked keys
5

Ask Readdy to Add the Payment Flow

Ask Readdy AI to add a Toss Payments checkout flow to the products, cart, or checkout button on your website.
Example website with a Toss Payments checkout flow

​
Best Practices

  • Tell Readdy AI which products, cart, or checkout button should use Toss Payments.
  • Use positive whole-won prices. Toss Payments currently supports one-time KRW payments in Readdy.
  • Review your Toss Payments contract and Payment Widget settings to confirm which payment methods customers can use.
  • Test the complete flow through your website’s share link or published URL before accepting live payments.
Readdy acts only as a platform that provides the Toss Payments integration and does not participate in payment processing. You receive funds directly through your Toss Payments account; Readdy does not hold these funds. Before going live, complete an end-to-end test and verify payment amounts and order statuses. If the records differ, check Toss Payments before fulfilling or refunding the order.

​
FAQ

Toss Payments is currently available to eligible accounts. Make sure you are signed in to the correct Readdy account. If the integration is still missing, submit a support ticket to request access.
Make sure you copied Payment Widget integration keys (결제위젯 연동 키), not individual API integration keys. The Client Key must use a test_gck_ or live_gck_ prefix, the Secret Key must use the matching test_gsk_ or live_gsk_ prefix, and both keys must come from the same merchant ID.
Readdy uses the connected backend to validate order amounts, create orders, protect your Secret Key, confirm payments with Toss Payments, and update the order only after payment succeeds.
Customers see the methods enabled in your Toss Payments contract and Payment Widget settings. If a payment method is missing, review your contract and Widget configuration in Toss Payments.

​
Need Help?

If this guide doesn’t resolve your issue, submit a support ticket. We’re here to help!