This page is about the menu  (SETTINGS) > PAYMENTS > PAYMENT GATEWAYS > STRIPE

1. Setup

To use this payment option you will need an account with Stripe.

To connect your Stripe Account click on the “Connect to Stripe” button, you will be prompted to log into Stripe and accept the connection for Stripe Payment Processing.

If you do not already have a Stripe account, click on the “Connect to Stripe” button and follow the on screen instructions to create one.

Stripe supports strong customer authentication and complies with the PSD2 regulations. You have security settings in your Stripe account. Please refer there for further information on 3D secure, PSD2 and other security matters.

To use Stripe to collect Channel payments ONLY and not show on your MASTERINSOFT Booking page, then use Enable = ‘Internal Only’

2 Functionality

2.1 Send credit card details to Stripe

If you set “Save all cards to Stripe” = Yes all credit cards including cards supplied by all channels will be sent directly to Stripe and not stored at MASTERINSOFT.

Credit card details can also be sent manually to Stripe using the send to Stripe button.


The card will be saved as a new customer in Stripe with the booking number as a reference. Once the new customer is created in Stripe the card can be charged.

Multiple cards can be sent for each Stripe customer and a specific one selected when charging.

Stripe will only accept valid cards. If Stripe reject the card, it’s details will still be visible at MASTERINSOFT.

Info Codes in the “Info” tab of the booking show you which action was performed.

Code Use
CARDTOSTRIPE card details were sent to Stripe
STRIPEPAYMENT payment imported from Stripe
STRIPEFAIL card could not sent to Stripe
CARDEXPIRES added when the card expires before check-in

2.2 Collect deposit for direct bookings at time of the booking

Use this instruction to set up deposit collection from your booking page.

Payments for bookings with deposit collection on the MASTERINSOFT booking page will be automatically collected and/or captured.

The card is stored at Stripe and can be charged manually or automatically again at a later date.

2.3 Send payment request

Use this instruction to create payment requests.

Payments for bookings with payment request will be automatically collected and/or captured.

The card is stored at Stripe and can be charged manually or automatically again at a later date.

2.4 Collect payment manually


You will see the paid amount in the “Charges and Payments” and “Invoice” tabs of the booking.

You can choose if the card is

  • immediately charged (Capture=Yes)
  • if you want to make sure that the amount is available for later capture (Capture=No) .

If the customer has multiple cards stored at Stripe you will be able to select the card you want to charge.

2.5 Collect payment automatically

Setting up pending payments to auto charge a card at a specific date is explained here.

2.6 Auto Charge Virtual Cards from OTAs

Some channels send virtual cards which are often only valid for a certain period. Virtual cards can be charged automatically when they become valid. This is how you activate this option:

  • Go to SETTINGS->CHANNEL MANAGER and set “Channel Collect Invoice” = Charges and Pending Payments
  • Go to the channel settings (for example SETTINGS->CHANNEL MANAGER->BOOKING.COM) and set “Virtual Cards” = Yes

2.6.1 Error when charging and Expedia Virtual Cards

When charging and Expedia Virtual Cards with Stripe you may receive this this error: An error occurred while processing this card

Possible reasons:

  • Merchant Code: The merchant code reflects your type of business (hotel, restaurant, grocery shop etc.). You can only charge a virtual card for a booking if you merchant code category (MCC) is relating to accommodation – 7011. Contact Stripe support and ask them to let your MCC code to reflect 7011.
  • Missing CVC: and Expedia do not always send a CVC for virtual cards. Ask the channel to provide a CVC for the virtual card and manually reenter it. For Expedia virtual cards you can try to add the generic CVC codes:
    • Visa/Mastercard: 469
    • American Express: 2469
  • Incorrect amount: Double-check you charge the exact amount sent by the channel from the booking.

3. Refund of Payments in Stripe

Payments can be manually refunded from within the Stripe account. You will also need to enter them manually into the booking if you wish to keep the booking invoice updated.

4. Stripe Test Mode

The easiest way to test is in live mode and either do not capture the charges or make small test payments and refund them from within Stripe when finished testing.

Stripe also has a test mode but not all functionality is enabled in this mode.

To connect to Stripe in testing mode, you can use your Stripe test publishable key and test secret key.

Pending payments will not work with the Stripe ApiKey connection method (i.e. test mode).

You must be disconnected from Stripe to begin.


Add the following to the end of the URL &showkeys

So the URL in the browser looks something like this:


Press the Enter key.

You will now have access to two additional settings where your Test Keys can be saved.

When you are finished testing, delete the two test keys and connect in live mode with the “Connect to Stripe” button.

Do not use API keys to connect in live mode, Stripe considers this insecure and will limit functionality.

5. Troubleshooting and Issues

Pending payment did not trigger

Pending payments will not work with the Stripe ApiKey connection method (i.e. test mode).

Stripe payment form does not show”

It has been reported that Browser IE 11 does not show the Stripe payment form when the booking page (and Stripe form) is in an iFrame unless the following Meta tag is included on the parent page.

Accept Cards without CVC

Log into your Stripe account and go to “Radar”. You should be able to process charges without the CVC once you turn off that requirement in Radar.