Quick navigation:
- What you need to set up
- Step 1: Set up the Billing Identifier
- Step 2: Set up the Payment Methods
- Important notes
- When the amount due updates in Duve
- Troubleshooting
- Restrictions & Limitations
- Tips & Tricks
- FAQs
What you need to set up
There are two things to set up:
- Billing Identifier: the ID of a Mews service, added in Duve.
- Payment Methods: the external payment types in your Mews account.
Step 1: Set up the Billing Identifier
In Mews:
-
Go to Menu > Services.
- Create an Additional Service, not a Bookable Service.
- Enter the name of the Additional Service and save.
-
Open the service and copy its ID from the page URL. It's the part that comes after
Detail/(see the highlighted part of the screenshot). This ID is your Billing Identifier.
In Duve:
-
Go to Guest Billing > Advanced options and paste the ID into the Billing Identifier field.
Note: Add the Billing Identifier for each brand or Mews connection, or payments won't sync.
Step 2: Set up the Payment Methods
- In Mews, go to Main menu > Settings > Property > Finance > Accounting configuration.
- Under External payment types, enable the payment methods you want to use.
- You must enable all of these:
- Visa
- Mastercard
- Amex
- Diners Club
- JCB
-
Credit card (used for any other card brand, such as Discover or UnionPay)
You're done!
Important notes
- Set the price of the service in Mews to 0 (in any currency) so the price isn't counted twice in Duve.
- The service doesn't show on the main billing page in Mews. You'll find it only in the Guest Profile, in the Folio.
When the amount due updates in Duve
Duve pulls the live folio from Mews so the reservation shows the correct amount due. This happens when:
- The guest reaches the Stay Payment page during Online Check-in.
- The host clicks Sync payments on the reservation.
- The host sends a message that includes any of these placeholders:
{{totalPrice}},{{rentPrice}},{{extraChargesPrice}},{{amountDue}}or{{rentPriceMonthlyAvg}}.
Troubleshooting
A payment was made in Duve but doesn't appear in Mews
- Make sure a Billing Identifier is saved in Duve for this brand or Mews connection. Without one, Duve doesn't send anything to Mews.
- Make sure the guest's card type is enabled under External payment types in Mews (see Step 2). Cards that aren't Visa, Mastercard, Amex, Diners Club or JCB are sent as Credit card, so that type must be enabled too.
- Check that the payment was charged. A payment that is only authorized (a hold that hasn't been captured yet) isn't sent until it's captured.
- Look in the Folio in the Guest Profile, not on the main billing page.
The amount due in Duve doesn't match Mews
- Click Sync payments on the reservation to pull the latest folio from Mews.
- Check that the service price in Mews is set to 0. A price on the service is counted on top of the amount Duve sends.
A refund isn't showing in Mews
- Refunds are sent to Mews as a negative payment labeled Refunded. Look for it in the guest's folio next to the original payment.
- See Restrictions & Limitations for when cancellations send a refund automatically.
Restrictions & Limitations
- Only card payments are sent to Mews. Cash payments and charges added to the guest's bill aren't posted as payments.
- If the guest paid with Mews Payments, Duve doesn't post the payment again because Mews already records it.
- Payments of 0 aren't sent.
- Authorized payments that haven't been captured aren't sent until they're captured.
- When a guest cancels an upsell, Duve automatically sends the refund to Mews. When a host cancels, the refund is sent only when it's processed as a refund in Duve.
- If the guest's billing account in Mews is a company rather than the guest, Duve can't read the live folio, and the amount due won't update.
- The Billing Identifier is set per brand or Mews connection, so each connection needs its own.
Tips & Tricks
- Find a payment fast: each payment Duve posts to Mews carries the Duve order ID as its external identifier and the service name in the notes, so you can search for it in Mews.
- One payment, several reservations: if a guest pays for more than one reservation in a single Payment for Stay, Duve splits the payment and posts each part to the matching reservation in Mews.
- Name the service clearly (for example, "Duve – Online Payments") so your front desk recognizes Duve payments in the folio.
-
Use placeholders to keep messages up to date: adding
{{amountDue}}to a pre-arrival message makes Duve pull the latest folio before sending, so the guest sees the correct balance.
FAQs
Q: Do I need a separate service for Payment for Stay and for upsells?
A: Each Payment for Stay and each upsell needs a service in Mews. Create it as an Additional Service, not a Product within a service.
Q: Why does the service price in Mews have to be 0?
A: Duve sends the amount with each item. If the service has its own price, Mews adds it on top, and the amount is counted twice.
Q: Why can't I see Duve payments on the Mews billing page?
A: The service is shown only in the Folio in the Guest Profile, not on the main billing page.
Q: Which card types do I need to enable?
A: Visa, Mastercard, Amex, Diners Club, JCB, and Credit card. Credit card is used for any other card brand.
Q: How often does the amount due update in Duve?
A: It updates whenever a live folio sync runs: when the guest opens the Stay Payment page, when you click Sync payments, or when a message with a price placeholder is sent. See When the amount due updates in Duve.
Q: I have more than one Mews connection. What do I need to do?
A: Add the Billing Identifier for each brand or Mews connection, or payments from that connection won't sync.
Comments
0 comments
Article is closed for comments.