Duve integrates with Planet, a payment service provider (PSP), so you can collect guest payments directly through the Guest app. Once connected, guests can pay their bill, buy upsells, and leave a pre-authorization (hold) on their card, all on a secure Planet-hosted payment page. If your property uses Oracle OPERA Cloud through OHIP, Duve can also push the Planet card token into the reservation in OPERA.
Quick navigation:
- Use cases
- Before you start
- How to set it up
- Step 1: Get your Planet credentials
- Step 2: Connect Planet in Duve
- OHIP integrations (Oracle OPERA Cloud)
- How the token push works
- Enable the token push
- Required: 24-character token on the Oracle side
- Guest experience
- Troubleshooting
- Restrictions & Limitations
- FAQs
Use cases
- Guest Billing: Let guests pay their reservation balance online before arrival.
- Additional Hold: Place a pre-authorization on the guest's card as a security deposit, without charging it.
- Upsells: Charge guests for early check-in, late check-out, room upgrades, and other products they buy in the Guest app.
Planet supports two payment flows in Duve:
- Direct charge: The card is charged immediately.
- Pre-authorization: The amount is held on the card and can be captured (settled) or released later.
Before you start
- You need an active Planet account with access to the Planet portal.
- You need your Planet API username and password (see Step 1).
- For the OHIP token push: your OHIP connection must already be set up in Duve, and OPI (the Oracle Payment Interface) must be active for the hotel in OPERA.
How to set it up
Step 1: Get your Planet credentials
- Log in to your Planet account.
- Go to UPP Administration > Security.
- Copy your username and password.
Step 2: Connect Planet in Duve
- In Duve, go to Settings > Billing.
- Scroll down to the credit card payment section.
- Select Planet.
- Enter the username and password from Step 1. Both fields are required.
- Click Connect.
Duve verifies the credentials with Planet. Once they are confirmed, the billing section shows that credit card payments are collected via Planet.
Note: To update your credentials later, click the menu next to the Planet connection and select Edit. To stop collecting payments, select Disconnect.
OHIP integrations (Oracle OPERA Cloud)
If your property is connected to Oracle OPERA Cloud through OHIP, Duve can push the guest's Planet card token to the reservation in OPERA. This lets your front desk charge or authorize the card in OPERA through OPI, without asking the guest for their card again.
How the token push works
- When a guest pays or leaves a hold through Planet, Planet tokenizes the card and returns a token to Duve.
- Duve adds the token to the OPERA reservation as a payment method, together with the card's last four digits, card type, expiry date, and the authorized amount.
- If the payment was a pre-authorization, Duve also registers the approval number as a manual authorization in OPERA, so the hold is visible on the reservation.
- Each token is pushed only once per order. The result (success or failure) is recorded in the reservation logs in Duve.
Enable the token push
- In Duve, open your OHIP integration settings.
- Turn on Push CC token via API.
- Save your changes.
Required: 24-character token on the Oracle side
For the token push to work on an OHIP and OPI account, Oracle must enable a token length of 24 characters on the OHIP/OPI side.
- This is a per-account setup. You (or your OPERA administrator) must request it from Oracle for each property.
- Until Oracle enables the 24-character token for that account, the token will not be pushed into OPERA, even if the token push is turned on in Duve.
Guest experience
- The guest selects what to pay for (bill, hold, or upsell) in the Guest app and is redirected to a secure Planet payment page.
- The payment page uses your brand color and is shown in the guest's language when supported (21 languages, including English, German, French, Italian, Spanish, Dutch, Portuguese, Japanese, and Chinese). Other languages fall back to English.
- After paying, the guest is returned to the Guest app.
Troubleshooting
-
"Connect" fails: Double-check the username and password from UPP Administration > Security in Planet. Make sure you copied the API credentials, not your portal login.
- Token does not appear in OPERA: Confirm that Oracle has enabled the 24-character token length for your account.
- Confirm that the token push toggle is on in your OHIP settings.
- Confirm that OPI is active for the hotel in OPERA. If OPI is not active, Duve skips the token push.
- Check the reservation logs in Duve for a failed token push entry.
- Token is not pushed for an order: Orders with a zero amount are not pushed to OPERA.
Restrictions & Limitations
- Accepted cards: Mastercard, Visa, American Express, Diners Club, and Discover.
- The OHIP token push requires OPI to be active in OPERA and the 24-character token length to be enabled by Oracle.
- Duve does not push tokens longer than 30 characters to OPERA.
FAQs
Q: Where do I find my Planet username and password?
A: In your Planet account, go to UPP Administration > Security.
Q: Can I use Planet for both charges and holds?
A: Yes. Planet supports direct charges and pre-authorizations for Guest Billing, Additional Hold, and Upsells.
Q: Can I refund a Planet payment from Duve?
A: Yes. Duve supports refunds, captures, and cancellations of Planet transactions.
Q: I turned on the token push, but tokens are not reaching OPERA. Why?
A: The most common reason is that Oracle has not yet enabled the 24-character token length for your OHIP/OPI account. Contact Oracle to request it. Also make sure OPI is active for your hotel.
Q: Do I need to request the 24-character token for every property?
A: Yes. It is a per-account setup on the Oracle side.
Q: Does the guest need to enter their card again at the front desk?
A: No. Once the token is pushed to OPERA, your front desk can use it through OPI.
Comments
0 comments
Article is closed for comments.