Ducumentation

Welcome to Hips! Get familiar with the Hips products and explore their features.

Hips Checkout

Hips Checkout is  PCI-free

Hips's embedded payment form, Checkout, simplifies and secures online payment processing. Quickly integrate Checkout into your site to provide your users with a streamlined, mobile-ready payment experience that is constantly improving. If you need help after reading this, check out our answers to common questions or chat live.

The easiest way to integrate Hips is via Checkout, an embedded tool that takes care of building an HTML form, validating user input, and securing your customers' card data. Using Checkout, sensitive credit card information is sent directly to Hips, and does not touch your server.

Checkout is a fairly high-level solution. For a more custom approach, you can create your own payment form using:

  • Hips.js Tokenization  PCI-free
  • Hips Payment API  PCI-required

Checkout Layouts

Layout NameDescriptionOne ClickRemember MePayment methodsExample
inlineFull checkout replacementYesYesMultiExample
cardOnly card inputYesYesCard onlyExample
card_elementSimple formYesYesCard onlyExample

Hips Checkout Example Request (inline)

$ curl --request POST \
   --url https://api.hips.com/v1/orders \
   --header 'accept: application/json' \
   --header 'Authorization: [YOUR PRIVATE KEY GOES HERE]' \
   --header 'content-type: application/json' \
   --data '{
    "order_id":"123",
    "purchase_currency":"USD",
    "user_session_id":"3246568465743",
    "user_identifier":"SmartShopper17",
    "meta_data_1":"any_custom_reference",
    "cart":{
       "items":[
          {
             "type":"physical",
             "sku":"3123123",
             "name":"Hips cup",
             "quantity":1,
             "unit_price":250,
             "discount_rate":0,
             "vat_rate":25,
             "meta_data_1":"Special color"
          }]
    },
    "require_shipping":true,
    "express_shipping":true,
    "hooks":{
     "user_return_url_on_success":"https://mystore.com/thank_you",
     "user_return_url_on_fail":"https://mystore.com/sorry",
     "terms_url":"https://mystore.com/terms",
    }
 }'
{
 "id":"UVWofp7AjHiRKNLjhUjMnhc3",
 "object":"order",
 "checkout_uri":"https://checkout.hips.com/UVWofp7AjHiRKNLjhUjMnhc3",
 "merchant_reference":{
   "meta_data_1":"any_custom_reference",
   "order_id":"12344553"
 },
 "purchase_currency":"USD",
 "status":"pending",
 "created_at":"2017-01-26T10:10:23.859Z",
 "last_modified_at":"2017-01-26T10:10:23.859Z",
 "expires_at":null,
 "require_shipping":true,
 "billing_address":null,
 "shipping_address":null,
 "cart":{
   "total_price_excluding_tax":11000,
   "tax":2749,
   "tax_formatted":"$27.49",
   "total_price_including_tax":13749,
   "total_price_including_tax_formatted":"$137.49",
   "total_price_inc_tax_and_including_coupon":13749,
   "total_price_inc_tax_and_including_coupon_formatted":"$137.49",
   "total_price":13749,
   "total_price_formatted":"$137.49",
   "items":[
     {
       "id":"HnY8erVezohaLvg4ka3zEL9W",
       "object":"order_item",
       "sku":"3123123",
       "name":"Hips cup",
       "quantity":1,
       "ean":null,
       "uri":null,
       "image_uri":null,
       "discount_rate":0,
       "vat_rate":25,
       "unit_price":250,
       "meta_data_1":"Special color"
     }]
 },
 "coupons":[]
}
<script src="https://cdn.hips.com/js/v1/hips.js"></script>
<script>
 Hips.checkout({
       token: 'UVWofp7AjHiRKNLjhUjMnhc3',
       style: {
         'mainColor': 'BA68D1',
         'secondColor': 'C29ACE',
         'font': 'Comic Sans MS'
       }
 });
</script>

Hips Checkout Example Result (inline) Live