Pass Stripe tokens to Cloudbeds

It’s possible to use Stripe Tokens (Customer ID or Charge ID) as parameters on postReservation API call.

If a property is connected to Stripe, the parameters cardToken and paymentAuthorizationCode can be sent as part of the postReservation body. The cardToken must be filled with a Stripe Customer ID, and the paymentAuthorizationCode must be filled with a Stripe Charge ID. The paymentAuthorizationCode can’t be sent without the cardToken, and the cardToken parameter requires the value on the paymentMethod param to be credit.

If the cardToken field is sent, we’ll validate the customer on Stripe and, if it’s valid, save it as a credit card internally, so that the hotel staff can use it to make following charges or authorizations on this Customer’s card.

If the paymentAuthorizationCode field is sent, we’ll validate the payment on Stripe and, if it’s valid, consider this payment good for the reservation deposit.

To save a credit card for further reuse, you must, before anything else, tokenize a credit card. This can be done on Stripe backend API itself, but using Stripe JavaScript SDK (or iOS  SDK or Android SDK) to tokenize the credit card directly without submitting the credit card data to your backend is most recommended.

After tokenization, you can use it to create a customer or attach it to an existing customer. This guide covers this approach.

A charge represents the final object generated by a payment. There are many ways to create a charge, such as the old Charge API itself, but currently using a Payment Intent is the most recommended approach as it’ll allow you to deal with authenticated payment flows (3D Secure, for example).

In the case of a Payment Intent usage, the Charge is created after the payment is confirmed and the authentication is either dismissed or fulfilled.

The rules described on Manage > Payment Options > Processing Methods > Mybooking Reservations are NOT APPLIED to reservations created via the API.

It means that if a cardToken is sent, the deposit won't be charged.  The payment needs to be added manually in the reservation.