Channex.io
  • Channex.io Documentation
  • About Channex & FAQ
  • Changelog
  • For OTA
    • Intro
    • Channex Shopping API
    • Open Channel API
  • FOR PMS
    • API Reference
    • API Rate Limits
    • Property Size Limits
    • Properties Collection
    • Property Users Collection
    • Groups Collection
    • Group Users Collection
    • Room Types Collection
    • Rate Plans Collection
    • Availability and Rates
    • Webhook Collection
    • Bookings Collection
    • Booking CRS API
    • Channel API
    • Photos Collection
    • Hotel Policy Collection
    • Facilities Collection
    • Taxes and Tax Sets
    • Applications API
    • Messages Collection
    • Reviews Collection
    • Availability Rules Collection
    • Stripe Tokenization App
    • Payment Application API
    • Channel Codes
    • Channel IFrame
    • PMS Certification Tests
  • Guides
    • PMS Integration Guide
    • Best Practices Guide
    • Test Account for Booking.com
    • Test Accounts for Airbnb
    • Channex Retention Periods
    • Guide to PCI
  • Application Documentation
    • Overview of App Documentation
    • Dashboard
    • Properties and Groups Management
    • Property Tasks
    • Rooms Management
    • Inventory Management
    • Channels Management
    • Channel Log
    • Bookings Management
    • Availability Rules
    • API Key Access
    • Change Log Feature
  • Google Guide
    • Connect Google Channel
    • Google Vacation Rental
    • My Hotel Shop (MHS) Google
  • Channel Mapping Guides
    • Agoda
    • Airbnb
    • Booking.com
    • Ctrip / Trip.com
    • Despegar
    • Dida Travel
    • Emerging Travel
    • Expedia
    • Feratel
    • Getaroom
    • Hipcamp
    • Hostelworld
    • Hopper
    • Hopper Homes
    • Hotelbeds
    • HotelTonight
    • HyperGuest
    • HRS
    • Inntopia
    • Instant Booking Page
    • MakeMyTrip / Goibibo
    • Mg Bedbank
    • OpenGDS
    • Roibos
    • Traveloka
    • Tiket.com
    • VRBO
  • App Guide
    • Apaleo
    • PCI App
Powered by GitBook
On this page
  • Create Credit Card Token
  • Create Payment Method Token
  • How to use token?

Was this helpful?

  1. FOR PMS

Stripe Tokenization App

API related to Stripe Tokenization App

PreviousAvailability Rules CollectionNextPayment Application API

Last updated 1 day ago

Was this helpful?

A lot of our customers use Stripe to charge guests and transfer money to Properties. It is excellent solution and works well without any headache except one - how to transfer Credit Card details from OTA to Stripe account. Usually, to perform this operation your system should be PCI DSS certified, because this operation required access to Raw Credit Card data.

Channex will offer a new way how to do that and dramatically decrease complexity - Stripe Tokenization App.

Basically, this Application allow you to do just one thing - pass Credit Card data from Channex PCI Storage into your Stripe Account.

To work with this API you should have:

  • connected PMS Stripe Account (you can do that at your User Profile)

  • installed Stripe Tokenization App (see Applications API)

When Stripe is connected and Application is installed, you will have access to two API methods:

  • Create Credit Card Stripe Token

  • Create Payment Method Token

Create Credit Card Token

Request:

POST /api/v1/stripe_tokenization_app/:app_installation_id/token

{
  "booking_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Success Response Example

Status Code: 200 OK

{
  "success": true,
  "data": {
    "token": "STRIPE_CREDIT_CARD_TOKEN"
  }
}

Unauthorised Error Response

Status Code: 401 Unauthorized

{
  "errors": { 
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}

Validation Error Response

Status Code: 422 Validation Error

{
  "errors": {
    "title": "Validation Error",
    "code": "validation_error",
    "details": {
      "booking_id": [
        "has no token"
      ]
    }
  }
}

Create Payment Method Token

Request:

POST /api/v1/stripe_tokenization_app/:app_installation_id/payment_method

{
  "booking_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Success Response Example

Status Code: 200 OK

{
  "success": true,
  "data": {
    "token": "STRIPE_PAYMENT_METHOD_TOKEN"
  }
}

Unauthorised Error Response

Status Code: 401 Unauthorized

{
  "errors": { 
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}

Validation Error Response

Status Code: 422 Validation Error

{
  "errors": {
    "title": "Validation Error",
    "code": "validation_error",
    "details": {
      "booking_id": [
        "has no token"
      ]
    }
  }
}

How to use token?

Once token is created, you are able to use it at your side in regular basis - create a charge or anything else.

Please, keep in mind, token will be created at your account and we are not have any access to this information.