17,539
edits
Changes
Jump to navigation
Jump to search
For more information please contact The template variable [AUTHORIZEUNTIL] returns the date until which a card is authorized. <span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> The extended authorization period beyond 7 days may only be available if your Stripe supportaccount business type is for a "hotel" or "lodging", other business types may be limited to 7 days.
You will see the paid amount in the "Charges and Payments" and "Invoice" tabs of the booking.
<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This function is only available if your = Manage payments manually === You can see the status of all payments stored at Stripe account is for a "hotel" the booking and have options as appropriate to capture an amount or "lodging"the full payment, refund an amount or the full payment and release an authorization. [[Image:stripe3.png|600px|link=]][[Media:stripe3.png|view large]]
no edit summary
|STRIPEFAIL
| card could not be sent to Stripe
|-
|-
|CARDFAILSTRIPE
| card has failed at Stripe, see the note for reason
|-
|}
<span style="color: #f3e504;" >{{#fas:lightbulb}} </span> You can use an Auto Action to mark bookings where the charging failed. A template is available which you can further customize. Use the context help (?Icons) in the Auto Action and on the help page (click on HELP in the top right menu) for further instructions.
=== Collect deposit for direct bookings at time of the booking ===
The card is stored at Stripe and can be charged manually or automatically again at a later date.
=== Collect payment authorization manually === To authorize the card to make sure that the amount is available for later manually capture set "Capture" = No
The maximum holding period depends on the the card type and the country the card is from:
*American Express 7 days
For more information please contact Stripe support.
=== Collect payment manually ===
[[Image:stripe1.png|600px|link=]]
[[Media:stripe1.png|view large]]
You can choose if the card is
*immediately charged and funds transferred to your Stripe account (Capture=Yes) *if you want to make sure that no funds transferred now but the amount is available for later capture up to an expiry date (Capture=No) .
If the customer has multiple cards stored at Stripe you will be able to select the card you want to charge.
=== Collect payment automatically ===
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 {{#fas:cog}} (SETTINGS)->CHANNEL MANAGER and set "Channel Collect Invoice" = Charges and Pending Payments*Go to the channel settings (for example {{#fas:cog}} (SETTINGS)->CHANNEL MANAGER->BOOKING.COM) and set "Virtual Cards" = Yes
====Error when charging Booking.com and Expedia Virtual Cards ====
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 your merchant code category (MCC) is relating to accommodation – 7011. Contact Stripe support and ask them to let set your MCC code to reflect 7011.
*'''Missing CVC''': Booking.com 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:
*'''Incorrect amount''': Double-check you charge the exact amount sent by the channel from the booking.
== Local Payment Methods ==
Stripe allows payment via many local payment methods based on the payers location.
'''Step 1: In Stripe'''
Local payment options can be enabled when available at the following Stripe menu:
https://dashboard.stripe.com/settings/payment_methods
Select the platform called "Payment Gateway" and you will see the payment methods available to you, these can be shown on your booking page and payment request page.
You can enable and disable each method as you wish. Note each payment method can have different fees and conditions and not all methods are instantly confirmed meaning the payment is not completed until some time after the booking is made.
'''Step 2: In Beds24'''
Set "Stripe Checkout Version" = Hosted
The guest will be redirected from the check-out page to a Stripe payment page where they can select with payment method they want to use.
If a payment method is selected where you do not receive payment immediately, the info code STRIPEPENDING is added to the booking. When the payment is made, this is deleted and replaced by STRIPEPAYMENT.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Google wallet will not work in an iFrame, if activating Google wallet please make sure your payment page is not within an iFrame.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Apple pay is whitelisted for the beds24.com domain, it will not work on other domains so please do not use it if you have your booking page on a white label domain.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Bancontact, if you activate this, there can be delays and it can take a few weeks before it is made available in your Stripe account.
== Refund of Payments in Stripe ==
Payments can be manually fully or partially refunded from within the booking which will also update the invoice. If you refund from within the Stripe account. You you will also need to enter them manually into the booking if you wish to keep the booking invoice updated. [[Image:stripe3.png|600px|link=]][[Media:stripe3.png|view large]]
== Stripe Test Mode ==
<span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''You must be disconnected from Stripe to begin.'''
Open the Stripe menu at {{#fas:cog}} (SETTINGS ,> ) PAYMENTS -> PAYMENT GATEWAYS -> STRIPE
Add the following to the end of the URL '''&showkeys'''
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Do not use API keys to connect in live mode, Stripe considers this insecure and will limit functionality.
== Change of Stripe Account ==
If you have had to change your Stripe account and have Bookings with Credit Cards already stored/authorised, you will need to clear the initial authorisation so you can send a new card to Stripe.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''ONLY USE THIS IF YOU HAVE CHANGED YOUR STRIPE ACCOUNT'''
In Beds24 -
*Go to ACCOUNT MANAGEMENT > MANAGE ACCOUNT > MANAGE PROPERTY > MANAGE ROOM > BOOKINGS.
*Tick the appropriate bookings,
*Select from the drop down box - 'Modify All Selected Bookings'
**Select 'Remove Payment Auth'
this will remove the authorisation from the initial account and allow new cards to be sent to the new Stripe Account.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''Please ensure you select only the bookings you need to have the credit card details cleared, it is NOT possible to restore if you erase by mistake.'''
==Examples and Use Cases==
{| class="wikitable"
! scope="col"| Use Case
! scope="col"| Link to help page
|-
|You want to collect a deposit at time of booking and the balance via Stripe prior to the Guest arriving.
|[[Stripe_deposit_and_balance|Deposit collected at time of booking and balance before Checkin]]
|-
|For bookings made within 14 days of arrival, you want to collect the full amount at the time of booking.
|[[Stripe_full_amount|Full payment collected at time of booking]]
|-
|You want to collect the full amount at the time of booking.
|[[Stripe_full_amount|Full payment collected at time of booking]]
|-
|You want to collect a refundable security deposit from the guest before arrival.
|[[Stripe_Security_Deposit_capture | Capture a refundable security deposit]]
|-
|You want to send a payment request to your guest so they can make the payment directly to Stripe.
|[[Stripe_Payment_Request|Send a payment request]]
|-
|You have received a telephone booking and need to send a payment request to your guest so they can make the payment.
|[[Stripe_Payment_Request|Send a payment request]]
|-
|Your property/guests need to comply with EU 3DSecure rules. The guest needs to make the payment.
|[[Stripe_Payment_Request|Send a payment request]]
|-
|You want to collect the guest credit card details at the time of booking to be charged later.
|[[Stripe_Credit_Card|Collect Credit card details to be charged later]]
|-
|Refundable bookings, you do not want to collect the payment/balance of the booking if the booking is cancelled during the cancellation period.
|[[Stripe_deposit_and_balance|Refundable bookings, payment not collected if cancelled]]
|-
| You receive Virtual cards from the channels and you want to auto process the payments.
|[[Stripe_Channel_Virtual_Cards|Auto Process Virtual Cards from the Channels]]
|-
|You have set up a payment schedule with VRBO and want to collect the payments when due.
|[[Stripe_Payment_Schedule |Collect payments with payment schedule]]
|-
|}
== Troubleshooting and Issues ==
'''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.
'''Change of Stripe Account - Unable to collect payments'''
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''ONLY USE THIS IF YOU HAVE CHANGED YOUR STRIPE ACCOUNT DUE TO STRIPE ACCOUNT BEING BLOCKED'''
In Beds24 - Go to ACCOUNT MANAGEMENT > MANAGE ACCOUNT > MANAGE PROPERTY > MANAGE ROOM > BOOKINGS.
Tick the appropriate bookings, this will remove the authorisation from the initial account and allow new cards to be sent to the new Stripe Account.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''Please ensure you select only the bookings you need to have the credit card details cleared, it is NOT possible to restore if you erase by mistake.'''
'''Virtual cards not accepted''': The merchant code reflects your type of business (hotel, restaurant, grocery shop etc.). You can only charge a virtual card for a booking if your merchant code category (MCC) is relating to accommodation – 7011. Contact Stripe support and ask them to set your MCC code to 7011.
