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

Fine-Tune Booking Stays with Restrictions by Date

Fine-Tune Booking Stays with Restrictions by Date

High-season buzzing? Low-season gaps? Seasonal Restrictions let you update your minimum and maximum night rules by date, so you can raise the bar when demand is hot and drop it when you need to fill rooms. Why use Seasonal Restrictions? High-season control: Increase...

Mangobeds Channel Manager: Sync Airbnb, Booking.com & More

Mangobeds Channel Manager: Sync Airbnb, Booking.com & More

Stop double-booking headaches. The Mangobeds Channel Manager keeps your calendars, rates, and availability perfectly aligned across every OTA, from Airbnb to Booking.com and beyond. Beyond syncing calendars, rates, and bookings, the Mangobeds Channel Manager can also...

No Empty Rooms: New Payments, New Rates, New Wins

No Empty Rooms: New Payments, New Rates, New Wins

We squeezed a ton of goodness into this release: faster payments, sharper pricing tools, and a dashboard that thinks ahead so you don’t have to. Grab a coffee and check what’s new. ☕ New Bookings dashboard improvements Weekly check-in view, see today plus the next 6...