Stripe: Difference between revisions
Jump to navigation
Jump to search
| (30 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category: | [[Category:Marketplace]] | ||
[[Category:Payments]] | [[Category:Payments]] | ||
[[Category:Payment_Gateways]] | [[Category:Payment_Gateways]] | ||
| Line 5: | Line 5: | ||
This page is about the menu {{#fas:cog}} (SETTINGS) > PAYMENTS > PAYMENT GATEWAYS > STRIPE | This page is about the menu {{#fas:cog}} (SETTINGS) > PAYMENTS > PAYMENT GATEWAYS > STRIPE | ||
__TOC__ | __TOC__ | ||
== Setup | =Summary= | ||
<div class="summarybox"> | |||
Beds24 integrates with several payment providers through which you can | |||
*collect payments for direct bookings | |||
*send payment requests which works for all bookings including bookings made on OTAs | |||
'''Beds24's partner Stripe is a reliable payment processor that offers the best and widest range of functionalities'''. With Stripe you can also '''auto charge guest credit cards and virtual cards from OTAs''' when the payments are due. | |||
Beds24 and Stripe together help to automate all your payment processing needs. | |||
</div> | |||
= Setup = | |||
To use this payment option you will need an account with Stripe. | To use this payment option you will need an account with Stripe. | ||
| Line 20: | Line 31: | ||
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 Beds24. | 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 Beds24. | ||
Credit card details can also be sent manually to Stripe using the send to Stripe button. | |||
Credit card details can also be sent manually to Stripe using the send to Stripe button. '''(Depreciated)''' | |||
[[Image:stripe2.png|600px|link=]] | [[Image:stripe2.png|600px|link=]] | ||
| Line 56: | Line 68: | ||
|STRIPEAUTHORIZE | |STRIPEAUTHORIZE | ||
| payment has been authorised by Stripe | | payment has been authorised by Stripe | ||
|- | |||
|STRIPEREFUND | |||
| refund has been processed at Stripe | |||
|- | |- | ||
| Line 63: | Line 79: | ||
|} | |} | ||
<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 === | === Collect deposit for direct bookings at time of the booking === | ||
| Line 125: | Line 143: | ||
Possible reasons: | 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 | *'''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 your merchant code category (MCC) is relating to accommodation – 7011. Contact Stripe support and ask them to set your MCC code to 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: | *'''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: | ||
| Line 134: | Line 152: | ||
== Local Payment Methods == | == Local Payment Methods == | ||
Stripe allows payment via many local payment methods based on the payers location. | 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 | https://dashboard.stripe.com/settings/payment_methods | ||
| Line 144: | Line 165: | ||
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. | 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. | |||
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> 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 == | == Refund of Payments in Stripe == | ||
| Line 169: | Line 198: | ||
<span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''You must be disconnected from Stripe to begin.''' | <span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''You must be disconnected from Stripe to begin.''' | ||
Open the Stripe menu at {{#fas:cog}} (SETTINGS) | Open the Stripe menu at {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > STRIPE | ||
Add the following to the end of the URL '''&showkeys''' | Add the following to the end of the URL '''&showkeys''' | ||
| Line 185: | Line 214: | ||
<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. | <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. | ||
==Disputes== | |||
When account holders dispute a payment with their bank, they must provide evidence and substantiate their claim. In many cases, the bank's aim is to protect its customers from having to pay for something that they did not authorise or that they believe has been misrepresented or damaged. | |||
As the seller, you have the right to dispute the account holder's claim and provide evidence to support your argument. Stripe has no control over the bank's decision, but our goal is to help you protect yourself from payment disputes. Our best practices provided here are based on our experience in resolving payment disputes. | |||
Here Stripe provides guidance on how to deal with disputes: | |||
*[https://docs.stripe.com/disputes General Information about disputes] | |||
*[https://docs.stripe.com/disputes/best-practices Best practices for disputes] | |||
*[https://docs.stripe.com/disputes/responding How to react to disputes (accept or dispute)] | |||
== Change of Stripe Account == | == 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. | 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. | ||
| Line 205: | Line 242: | ||
==Examples and Use Cases== | ==Examples and Use Cases== | ||
{| class="wikitable" | {| class="wikitable" | ||
! scope="col"| Use Case | ! scope="col"| Use Case | ||
| Line 255: | Line 290: | ||
|[[Stripe_Payment_Schedule |Collect payments with payment schedule]] | |[[Stripe_Payment_Schedule |Collect payments with payment schedule]] | ||
|- | |- | ||
|} | |} | ||
| Line 261: | Line 295: | ||
== Troubleshooting and Issues == | == Troubleshooting and Issues == | ||
'''Pending payment did not trigger''' | |||
Pending payments will not work with the Stripe ApiKey connection method (i.e. test mode). | 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. | 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. | ||
<meta http-equiv="x-ua-compatible" content="IE=edge"> | <meta http-equiv="x-ua-compatible" content="IE=edge"> | ||
| Line 276: | Line 310: | ||
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. | 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.''' | <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. | |||