2Checkout Connection Guide with Mangobeds

2Checkout (now Verifone) is a merchant-of-record payment provider with unusually broad reach. When Stripe or PayPal are limited in your country, 2Checkout lets you accept guest card payments in over 100 currencies while it handles tax and compliance as the seller of record. You can now connect it to Mangobeds and have bookings reconciled automatically.


Before you start (what you need)

  • An activated 2Checkout (Verifone) merchant account. While your account is in demo mode you can only place test orders.
  • Your 2Checkout Merchant Code, Buy link secret word and Secret Key.
  • Access to your 2Checkout Control Panel to add a notification (IPN) URL and a redirect domain.

Where to find your credentials in 2Checkout

  1. Log in to your 2Checkout Control Panel.
  2. Go to Integrations → Webhooks & API.
  3. In the API section, copy your Merchant Code and your Secret Key.
  4. In the Secret word section, copy your Buy link secret word.

Heads-up: the Buy link secret word and the Secret Key are two different values with two different jobs. The Buy link secret word signs the checkout link; the Secret Key verifies the payment notification. Treat both like passwords and never share them by email.

Add the notification (IPN) URL

2Checkout tells Mangobeds when a payment is completed through an Instant Payment Notification (IPN). You set this once in your Control Panel.

  1. Go to Integrations → Webhooks & API → IPN settings and click Add IPN URL.
  2. Set the IPN URL to https://www.mangobeds.com/api/webhooks/twocheckout.
  3. Under Hashing algorithms, tick SHA2 and MD5, then save.

If this IPN URL is missing, payments will succeed in 2Checkout but bookings in Mangobeds will not be marked as paid.

Whitelist the redirect domain

After paying, the guest is sent back to Mangobeds. 2Checkout only allows redirects to approved domains.

  1. Go to Setup → Ordering options → Redirect domains and click Add domain.
  2. Add mangobeds.com. Any subdomain and page on that domain is then allowed.

Supported countries

2Checkout accepts merchants in over 200 countries and can bill guests in more than 100 currencies, which makes it a good fit for markets where Stripe or PayPal are limited. As the merchant of record, 2Checkout handles tax and fraud, and you receive net payouts.

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 2Checkout (Verifone) as the provider.
  3. Paste:
    • 2Checkout Merchant Code
    • 2Checkout Buy Link Secret Word
    • 2Checkout Secret Key
  4. Tick the box confirming you’ve read this guide.
  5. Save to create the payment account, then Connect it to the property. Mangobeds checks your Merchant Code and Secret Key with 2Checkout before saving.

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

How a guest payment works

  • Mangobeds redirects the guest to 2Checkout’s hosted checkout page.
  • The guest pays by card in the booking currency.
  • 2Checkout notifies Mangobeds automatically through the IPN once the payment is confirmed.
  • Mangobeds marks the booking’s payment as Succeeded and sends you the usual property notification.

Wrap-up

2Checkout opens up card payments in markets where other processors fall short, with tax and compliance handled for you. Grab your Merchant Code and secrets, add the IPN URL and redirect domain, connect in Mangobeds, and your guests can pay on a secure hosted checkout while your bookings reconcile automatically.

You may also like

Track Maintenance, Guest Requests, Incidences, Tasks, and more with Mangobeds

Track Maintenance, Guest Requests, Incidences, Tasks, and more with Mangobeds

Mangobeds Tickets bring maintenance jobs, guest requests, incidences, housekeeping issues, and any task into one structured list — assigned, prioritized, and trackable to resolution. Tickets replace and extend the old Reminders feature, with priorities, assignees, photo attachments, and guest-portal reporting.