iTips tipping API

Additional motivation for staff to build beneficial relationships with guests and additional income at no cost to the business. Personal and team accounts for staff, allowing to receive tips even for employees who don’t interact directly with guests. Intuitive, easy-to-use, no app tipping transactions with no awkward interactions. Planned tip growth of 60%+. Excellent stats & guest reviews are available for business owners.

Using API integration and/or QR-codes for organizational accounts that provides the following use cases:

• Create payment API integration and/or QR-codes for your organization.
• Get usage statistics for your organization's API integration and/or QR-codes.
• Adjust & customize the UX to your company needs.

To access the API you will need the Endpoint, API Key, data-set-id, revision-id, and asset-id of your subscription. These are unique for each subscription.

You can find your API key in an email from a member of iTips staff. You need active account at https://i-tips.uk .

Other parameters:data-set-id, revision-id, and asset-id are located under “Asset Overview” section.

For example:

This request allows to validate that you are connected to correct organization account from https://i-tips.uk .

aws dataexchange send-api-asset \ --data-set-id [REPLACE_ME] \ --revision-id [REPLACE_ME] \ --asset-id [REPLACE_ME] \ --method GET \ --path "/status" \ --request-headers 'x-api-key=[REPLACE_ME_FROM_SUPPORT]'

Request should return the id of your linked establishment from https://i-tips.uk .

{ "id": "est_QK6Znw1dLe0mJB5XPJr3YNza", "establishmentName": "[Your establishment name]", "ownerName": "[Your owner info]" }

This request allows you to list created payment QR-Codes for your establishment.

aws dataexchange send-api-asset \ --data-set-id [REPLACE_ME] \ --revision-id [REPLACE_ME] \ --asset-id [REPLACE_ME] \ --method GET \ --path "/qr-codes" \ --request-headers 'x-api-key=[REPLACE_ME_FROM_SUPPORT]'

The response should contain list of created payment QR-Codes.

{ "id": "link_Lwao9dAqMWDwOkDObyrzkZKj", "description": "Some QR Code", "paymentText": "Some payment text", "presetAmount1": "5", "presetAmount2": "10", "presetAmount3": "30", "currencyCode": "EUR", "qrCodeFileName" : "https://[link_to_you_qr_code]" }

This request allows you to create payment QR-code, associated with linked establishment

aws dataexchange send-api-asset \ --data-set-id [REPLACE_ME] \ --revision-id [REPLACE_ME] \ --asset-id [REPLACE_ME] \ --method POST \ --path "/qr-codes" \ --request-headers 'x-api-key=[REPLACE_ME_FROM_SUPPORT]' \ --body "{\"description\":\"AWS API Code GBP\",\"paymentText\":\"Show me the money\",\"presetAmount1\":1,\"presetAmount2\":3,\"presetAmount3\":5,\"currencyCode\":\"GBP\"}"

Available currency codes are: 'EUR', 'GBP'.

Correct response will contain link to created QR-code in .png format.

{ "id": "link_Lwao9dAqMWDwOkDObyrzkZKj", "description": "Some QR Code", "paymentText": "Some payment text", "presetAmount1": "5", "presetAmount2": "10", "presetAmount3": "30", "currencyCode": "EUR", "qrCodeFileName" : "https://[link_to_you_qr_code]" }

This request allows to recieve information about total income by organization QR-code for the period.

aws dataexchange send-api-asset \ --data-set-id [REPLACE_ME] \ --revision-id [REPLACE_ME] \ --asset-id [REPLACE_ME] \ --method GET \ --path "/report" \ --request-headers 'x-api-key=[REPLACE_ME_FROM_SUPPORT]' \ --query-string-parameters 'links=link_dNoam5bWGxD5Q5D6LjPYyEzZ,from=2023-02-01T00:00:00Z,to=2023-05-29T00:00:00Z'

Parameters from and to should be in UTC time format. Parameter links should contain list of QR-code id's. Only own QR-code id's can be used.

Correct response will contain income for the period

{ "id": "link_dNoam5bWGxD5Q5D6LjPYyEzZ", "totals": [ { "paymentAmount": "1.00", "paymentCurrency": "GBP" } ] }

---

• Link to terms of usage 

---

• If you have questions about our products, contact us using email tech@itips.ai .

---

iTips is a digital tipping solution based on instant tips and guest feedback using an API integration and/or QR-code, designed for a wide range of service industries. When you, as a Client, accept these Terms and Conditions, we become your non-exclusive agent to pass on advice from your customers to you.

• Company Fact Sheet