Toss Payments Connection Guide with Mangobeds

If you host in South Korea, you can now charge guests through Toss Payments right inside Mangobeds. Guests pay with credit and debit cards, easy-pay (Toss Pay, Naver Pay, Kakao Pay), bank transfer and virtual accounts in KRW through Toss’s hosted checkout, while you keep clean reconciliation in one place.


Before you start (what you need)

  • An active Toss Payments account. A live account requires a Korean business registration; test keys are available without one.
  • Your Toss Client Key and Secret Key.
  • Your Mangobeds property currency set to KRW (Korean Won).

Where to find your API keys in Toss Payments

  1. Log in to the Toss Payments Developer Center (개발자센터).
  2. Open API Keys.
  3. Copy the Client Key and Secret Key. Use the live keys (live_ck_ / live_sk_) for real payments, or the test keys (test_ck_ / test_sk_) for testing.

Heads-up: the Secret Key is the secret half of your credentials, so treat it like a password. Don’t share it over email or paste it into chat.

Register the webhook (required)

Toss tells Mangobeds when a payment is completed through a webhook, which you register once in your Toss account. Unlike some providers, this step is not automatic, so please add it yourself. In the Toss Payments Developer Center go to Webhooks, add a new webhook and set:

  • Webhook URL: https://www.mangobeds.com/api/webhooks/toss
  • Event: PAYMENT_STATUS_CHANGED

Card payments are confirmed the moment the guest returns to Mangobeds, but the webhook is what marks asynchronous payments (such as virtual-account bank transfers) as paid once the deposit lands. Without it, those payments will succeed in Toss but the booking in Mangobeds may not be marked as paid.

Supported country

Toss Payments is available for properties in South Korea, settling in Korean Won (KRW). Guests can pay with credit and debit cards, easy-pay (Toss Pay, Naver Pay, Kakao Pay), bank transfer and virtual accounts.

How to set it up in Mangobeds

  1. Go to: Property → Settings → Payment Accounts → Connect Payment Account.
  2. In Create a new payment account, choose Toss Payments as the provider.
  3. Paste:
    • Toss Client Key
    • Toss Secret Key
  4. Make sure the webhook above is registered in your Toss account.
  5. Tick the box confirming you’ve read this guide.
  6. Save to create the payment account, then Connect it to the property.

Heads-up: once a property is linked to a payment account, you can’t swap providers on that property without removing the connection first.

Wrap-up

If you host in South Korea, connecting Toss Payments to Mangobeds gives your guests the local methods they expect (cards, easy-pay, bank transfer and virtual accounts) through a secure hosted checkout, while keeping your ops tidy with automatic payment reconciliation. Grab your API keys, register the webhook, connect, and you’re live.

You may also like

The Update That Makes Bookings Easier to Create, Fill, and Manage

The Update That Makes Bookings Easier to Create, Fill, and Manage

This release is about speed and control. We made the booking creation process faster, improved how the system suggests periods to maximize occupancy, added Google Hotel Search to the channel manager, and brought a number of practical improvements to payments, calendars, and daily navigation.