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

CoDNX Now Integrates with Mangobeds

CoDNX Now Integrates with Mangobeds

Great news for colivings that run community events and cohorts: CoDNX now plugs into Mangobeds. Bring the visibility and demand from CoDNX into your PMS while keeping availability accurate across rooms and properties—without manual updates. What is CoDNX? CoDNX is a...

Mangobeds App: Get it on iOS and Android

Mangobeds App: Get it on iOS and Android

Good news: you can run Mangobeds from your pocket. Create and manage bookings, check payments, and keep an eye on your properties—without opening a laptop. What you can do on mobile Check bookings fast: today’s arrivals/departures, guest details, notes. Create &...

Coupons with Limits, Cleaner Invoices, and Faster Exports

Coupons with Limits, Cleaner Invoices, and Faster Exports

This round is about control and clarity. Coupons have better limits, invoices read right, exports are easier, and your data flows better. We also added helpful docs you can attach to bookings and a full guide for PayU LATAM. Coupons that match your rules You can set...