Difference between revisions of "Stripe Credit Card"

From Beds24 Wiki
Jump to navigation Jump to search
 
(8 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
[[Category:How to]]
 
[[Category:How to]]
 
[[Category:Payments]]
 
[[Category:Payments]]
[[Category:Stripe]]
+
 
 
<div class="heading">Stripe - Collect the Guest credit card to collect the payment later. </div>
 
<div class="heading">Stripe - Collect the Guest credit card to collect the payment later. </div>
  
  This page is about the menu {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > STRIPE and automatic payment collection.
+
This page is about the menu {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > STRIPE and automatic payment collection and explains how to setup your payment collection and collect the payment from the guest credit card saved at Stripe.  
 
 
This page explains how to setup your payment collection and collect the payment from the guest credit card saved at Stripe.  
 
  
 
__TOC__
 
__TOC__
Line 33: Line 31:
  
 
=Set up=
 
=Set up=
==='''Step 1:'''  Setup your Booking Rules for Payment Collection===
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 1: Setup your Booking Rules for Payment Collection
 +
</div>
 +
<div class="mw-collapsible-content">
 +
 
  
 
Go to {{#fas:cog}} (SETTINGS)  PROPERTIES > BOOKING RULES > NORMAL BOOKINGS.
 
Go to {{#fas:cog}} (SETTINGS)  PROPERTIES > BOOKING RULES > NORMAL BOOKINGS.
Line 42: Line 45:
  
 
*Days in Advance = Not used  
 
*Days in Advance = Not used  
 +
</div></div>
  
==='''Step 2:''' Setup Stripe Account ===
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 2: Setup Stripe Account
 +
</div>
 +
<div class="mw-collapsible-content">
  
 
Go to {{#fas:cog}} (SETTINGS)  PAYMENTS > PAYMENT GATEWAYS > STRIPE and set:
 
Go to {{#fas:cog}} (SETTINGS)  PAYMENTS > PAYMENT GATEWAYS > STRIPE and set:
Line 56: Line 64:
 
*'''Title''' - Customise the title for this payment option.
 
*'''Title''' - Customise the title for this payment option.
 
*'''Instruction''' - Create an optional description to appear next to the Stripe pay now button.
 
*'''Instruction''' - Create an optional description to appear next to the Stripe pay now button.
 +
</div></div>
  
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 3: Create Auto Actions - (Optional)
 +
</div>
 +
<div class="mw-collapsible-content">
  
==='''Step 3:''' Create Auto Actions - Optional ===
+
Go to {{#fas:cog}} (SETTINGS)  GUEST MANAGEMENT > AUTO ACTIONS and click '''Create New Action''' to create them.
  
Go to {{#fas:cog}} (SETTINGS)  GUEST MANAGEMENT > AUTO ACTIONS
+
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you want to automatically collect the payment from the guest credit card later, then you will need to setup Auto Actions. Alternatively you can collect the payment manually either in your Stripe Dashboard or using the Stripe button Charges & Payments Tab.
  
If you want to automatically collect the payment from the guest credit card later, then you will need to setup Auto Actions. Alternatively you can collect the payment manually either in your Stripe Dashboard or using the Stripe button Charges & Payments Tab.
 
  
<div class="mw-collapsible mw-collapsed">
+
'''Auto Action 1 - Add a pending payment to the booking to automatically collect payment'''
<div class="headline-collapse" >
 
====Auto Action 1 - Automatically collect payment====
 
  
 
For all bookings, Direct and Channel/OTAs.  
 
For all bookings, Direct and Channel/OTAs.  
 
</div>
 
<div class="mw-collapsible-content">
 
Click '''Create New Action'''
 
  
 
Trigger tab:
 
Trigger tab:
Line 80: Line 87:
 
**Time Window = 14 days (set this to the same number (positive) as Trigger time.
 
**Time Window = 14 days (set this to the same number (positive) as Trigger time.
 
*Booking Source
 
*Booking Source
**Booking Source =All (this will apply to all bookings, direct, manual and channels)
+
**Booking Source =All (this will apply to all bookings, direct, manual and channels). If you want to have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.
If you want to have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.  
 
  
 
*Booking Conditions
 
*Booking Conditions
Line 89: Line 95:
 
*Info Codes
 
*Info Codes
 
**Exclude Booking Info code = BOOKINGVIRTCARD, EXPEDIACOLLECT, AGODACOLLECT
 
**Exclude Booking Info code = BOOKINGVIRTCARD, EXPEDIACOLLECT, AGODACOLLECT
If you receive virtual credit cards from the channels, then enter the Booking Info codes to prevent additional pending payments being added to bookings.
+
 
 +
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you receive virtual credit cards from the channels, then enter the Booking Info codes to prevent additional pending payments being added to bookings.
  
 
Booking tab: Optional
 
Booking tab: Optional
Line 112: Line 119:
 
**Payment time = set the time to collect payment
 
**Payment time = set the time to collect payment
 
**Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.
 
**Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.
</div>
 
</div>
 
  
====Auto Action 2 - Automatically collect a payment for the one night of the booking ====
+
 
 +
'''Auto Action 2 - Automatically collect a payment for the one night of the booking '''
  
 
For all bookings, Direct and Channel/OTAs. "One Night of Charges" - will use the average price of a night calculated from the sum over all nights.
 
For all bookings, Direct and Channel/OTAs. "One Night of Charges" - will use the average price of a night calculated from the sum over all nights.
 
</div>
 
<div class="mw-collapsible-content">
 
Click '''Create New Action'''
 
  
 
Trigger tab:
 
Trigger tab:
Line 129: Line 131:
 
**Time Window = 14 days (set this to the same number (positive) as Trigger time.
 
**Time Window = 14 days (set this to the same number (positive) as Trigger time.
 
*Booking Source
 
*Booking Source
**Booking Source =All (this will apply to all bookings, direct, manual and channels)
+
**Booking Source =All (this will apply to all bookings, direct, manual and channels). If you want to have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.
If you want to have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.  
 
  
 
*Booking Conditions
 
*Booking Conditions
Line 138: Line 139:
 
*Info Codes
 
*Info Codes
 
**Exclude Booking Info code = BOOKINGVIRTCARD, EXPEDIACOLLECT, AGODACOLLECT
 
**Exclude Booking Info code = BOOKINGVIRTCARD, EXPEDIACOLLECT, AGODACOLLECT
If you receive virtual credit cards from the channels, then enter the Booking Info codes to prevent additional pending payments being added to bookings.
+
 
 +
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you receive virtual credit cards from the channels, then enter the Booking Info codes to prevent additional pending payments being added to bookings.
  
 
Booking tab: Optional
 
Booking tab: Optional
Line 159: Line 161:
 
**Payment time = set the time to collect payment
 
**Payment time = set the time to collect payment
 
**Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.
 
**Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.
 +
</div></div>
 +
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 4: Manually collect payments via Stripe
 
</div>
 
</div>
</div>
+
<div class="mw-collapsible-content">
 +
 
 +
To manually collect a payment using your Stripe Connection see [[Stripe#Collect_payment_manually|here]] for instructions.
 +
</div></div>
 +
 
 +
=Credit Card details at Stripe=
 +
 
 +
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 Beds24.
 +
 
 +
Info Codes in the "Info" tab of the booking show you which action was performed.
 +
 
 +
{| class="wikitable"
 +
! scope="col"| Code
 +
! scope="col"| Use
 +
|-
 +
 
 +
|CARDTOSTRIPE
 +
| card details were sent to Stripe
 +
|-
 +
 
 +
|STRIPEPAYMENT
 +
| payment imported from Stripe
 +
|-
 +
 
 +
|STRIPEFAIL
 +
| card could not be sent to Stripe
 +
|-
 +
 
 +
|CARDEXPIRES
 +
| added when the card expires before check-in
 +
|-
 +
 
 +
|STRIPEAUTHORIZE
 +
| payment has been authorised by Stripe
 +
|-
 +
 
 +
|STRIPEREFUND
 +
| refund has been processed at Stripe
 +
|-
 +
 
 +
|CARDFAILSTRIPE
 +
| card has failed at Stripe, see the note for reason
 +
|-
  
==='''Step 4:''' Manually collect payments via Stripe===
 
  
To manually collect a payment using your Stripe Connection see [[Stripe#Collect_payment_manually|here]] for instructions.
+
|}

Latest revision as of 08:59, 29 July 2024


Stripe - Collect the Guest credit card to collect the payment later.
This page is about the menu  (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > STRIPE and automatic payment collection and explains how to setup your payment collection and collect the payment from the guest credit card saved at Stripe. 

1 Use

You can use this method if:

You have a Stripe account and you have connected it to your property.

And

You have bookings from your direct booking page.

And/Or

You have bookings from booking Channels/OTAs.

If you are in the EU and/or have guests from the EU, you may need to comply with 3DSecure Payments, this will require you to send a payment link to the guest to make the payment directly.

2 How it works

Credit card details will be sent to Stripe and you can collect a payment.

You can define the Payment Due date/time and the amount of the payment.

3 Set up

Step 1: Setup your Booking Rules for Payment Collection


Go to (SETTINGS) PROPERTIES > BOOKING RULES > NORMAL BOOKINGS.

  • Select “Booking Type” = Confirmed with credit card - card details are collected.

Go to (SETTINGS) PROPERTIES > BOOKING RULES > NEAR TERM BOOKINGS. (optional)

  • Days in Advance = Not used

Step 2: Setup Stripe Account

Go to (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > STRIPE and set:

Stripe is compatible with the pending payments auto charge function and direct charging a stored card from bookings, when you connect via the ‘Connect’ Button.

  • Click Connect Button. If you have multiple Stripe Accounts, ensure you connect to the correct Stripe account in your Stripe dashboard.
  • Set Enable/Priority - if you plan to use multiple Payment gateways, set the number based on the order on the payment page.
  • Save all cards to Stripe = Yes.
  • Capture = Yes, for your Beds24 booking page, this will collect the payment at the time of the booking.
  • Payment Description - Description for Stripe payments, template variables can be used. This description will be seen in the STRIPE dashboard, this is not visible to the Guest.
  • Title - Customise the title for this payment option.
  • Instruction - Create an optional description to appear next to the Stripe pay now button.

Step 3: Create Auto Actions - (Optional)

Go to (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS and click Create New Action to create them.

If you want to automatically collect the payment from the guest credit card later, then you will need to setup Auto Actions. Alternatively you can collect the payment manually either in your Stripe Dashboard or using the Stripe button Charges & Payments Tab.


Auto Action 1 - Add a pending payment to the booking to automatically collect payment

For all bookings, Direct and Channel/OTAs.

Trigger tab:

  • Time
    • Trigger Event = Checkin
    • Trigger Time = -14 days (set the time you want to collect the payment)
    • Time Window = 14 days (set this to the same number (positive) as Trigger time.
  • Booking Source
    • Booking Source =All (this will apply to all bookings, direct, manual and channels). If you want to have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.
  • Booking Conditions
    • Group Booking Trigger = Trigger only Master
    • Status = All not cancelled
    • Invoice Balance= Not Zero (can be used to refine the auto action being triggered)
  • Info Codes
    • Exclude Booking Info code = BOOKINGVIRTCARD, EXPEDIACOLLECT, AGODACOLLECT

If you receive virtual credit cards from the channels, then enter the Booking Info codes to prevent additional pending payments being added to bookings.

Booking tab: Optional

  • Flag Text = Payment (for example)
  • Flag Colour = select the colour as this will be visible in the Calendar/Bookings list

Booking Info tab: Optional, for information and reporting

  • Booking Info Code = PAYMENT (for example enter the value - use one word only)
  • Booking Info Text = Enter the description/text to show in for the Booking Info Code.

Invoice tab:

ONLY use Payment Type =‘ Percent of Group balance due’ if you selected Trigger tab > Booking Conditions > Group Booking Trigger = Trigger Only Master.
  • Add a Pending Payment to the booking
    • Payment Type = Percent of Group Balance due (select on what the payment is calculated)
    • Description = the text you will see in the "Charges and Payments" tab
    • Status = if you use the status function add the status you want to apply to the pending payment (optional)
    • Amount = 100 (this will be 100% of the outstanding balance)
    • Payment Rule = Auto
    • Payment Due = Trigger date
    • Payment time = set the time to collect payment
    • Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.


Auto Action 2 - Automatically collect a payment for the one night of the booking

For all bookings, Direct and Channel/OTAs. "One Night of Charges" - will use the average price of a night calculated from the sum over all nights.

Trigger tab:

  • Time
    • Trigger Event = Checkin
    • Trigger Time = -14 days (set the time you want to collect the payment)
    • Time Window = 14 days (set this to the same number (positive) as Trigger time.
  • Booking Source
    • Booking Source =All (this will apply to all bookings, direct, manual and channels). If you want to have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.
  • Booking Conditions
    • Group Booking Trigger = Trigger only Master
    • Status = All not cancelled
    • Invoice Balance= Not Zero (can be used to refine the auto action being triggered)
  • Info Codes
    • Exclude Booking Info code = BOOKINGVIRTCARD, EXPEDIACOLLECT, AGODACOLLECT

If you receive virtual credit cards from the channels, then enter the Booking Info codes to prevent additional pending payments being added to bookings.

Booking tab: Optional

  • Flag Text = OneNight (for example)
  • Flag Colour = select the colour as this will be visible in the Calendar/Bookings list

Booking Info tab: Optional, for information and reporting

  • Booking Info Code = ONENIGHT (for example enter the value - use one word only)
  • Booking Info Text = Enter the description/text to show in for the Booking Info Code.

Invoice tab:

  • Add a Pending Payment to the booking
    • Payment Type = One night of charges
    • Description = the text you will see in the "Charges and Payments" tab
    • Status = if you use the status function add the status you want to apply to the pending payment (optional)
    • Amount = 100 (this will be 100% of the one night of charges)
    • Payment Rule = Auto
    • Payment Due = Trigger date
    • Payment time = set the time to collect payment
    • Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.

Step 4: Manually collect payments via Stripe

To manually collect a payment using your Stripe Connection see here for instructions.

4 Credit Card details at Stripe

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 Beds24.

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 be sent to Stripe
CARDEXPIRES added when the card expires before check-in
STRIPEAUTHORIZE payment has been authorised by Stripe
STRIPEREFUND refund has been processed at Stripe
CARDFAILSTRIPE card has failed at Stripe, see the note for reason