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

How to Export Your Data in Mangobeds

How to Export Your Data in Mangobeds

Exporting your data from Mangobeds is a simple and efficient way to manage your bookings, guests, payments, and invoices. Each type of data is exported from the place where you manage it, so you always know where to look — bookings from the calendar, guests, payments and invoices from their respective apps.

Let guests change their room and fill the gaps to increase revenue

Let guests change their room and fill the gaps to increase revenue

Hey there 👋 Check out the latest improvements we have working on to help you manage your Coliving in the most efficient way! 📆 Book multiple rooms and changes  Guests can book different rooms for different periods and change the room before checking out without...

Getting Bookings from Your Website with Mangobeds

Getting Bookings from Your Website with Mangobeds

Getting Bookings from Your Website with Mangobeds If you want to manage bookings directly from your website using Mangobeds, you have two convenient options: redirecting users to the booking form link or embedding the booking form directly into your website. Here’s...