Stripe api key & connect

To enable your Stripe integration to make requests to the Utilmate API, you'll need to create an API Keys (Secret Key and Publishable Key). These keys are required when you connect to Stripe in Utilmate (Maintenance menu, System Configuration and select Add On's).

Tip: Publishable and secret keys are unique identifiers that are passed between computer programs allowing them to communicate with each other.  When a request is made, Stripe matches the keys you entered in Utilmate to the ones Stripe has stored, in order to authenticate and identify the requestor and ensure that they have the appropriate permissions.

Publishable API keys

Publishable keys begin pk_live_ 

Publishable API keys are used to identify your account with Stripe. They’re designed to be used where the code is publicly accessible, such as in client-side code (JavaScript in web browsers) or mobile apps.

While they identify the account, they don’t expose sensitive operations. However, they play an essential role in the creation of tokens and other operations that require visibility but not sensitive actions.

Secret API keys

Secret keys begin with sk_live_

Secret API keys are confidential and allow full control over any resources linked with your Stripe account, including making charges and refunds. They are meant to be stored securely on your server and used only for server-side API requests. They should never be exposed or transmitted openly.

Exposing a secret Stripe key is akin to giving malicious users full access to your Stripe account, allowing them to make unauthorised transactions or refunds. A leaked secret key can lead to financial losses, damaged reputation, and breach of trust with customers. It’s essential to rotate keys immediately if there’s any suspicion of them being compromised.

How to get your API keys

Go to the Stripe portal and log in (you will require your Stripe account credentials) and navigate to the Developers tab.

Note:  You need to be in Live mode.  Toggle to turn off Test mode.

Click on the API Keys tab and your publishable key and secret key are displayed.

You'll need to copy your publishable and secret key. These keys need to be entered into your Stripe Connect screen in Utilmate. 

To reveal the secret key, click on the Reveal live key button.

Enter your verification code.

Important: Live mode key access: You can only reveal a live mode secret or restricted API key once. If you lose it, you can’t retrieve it from the Dashboard. In that case, roll it or delete it and create a new one.

Enter Publishable Key and Secret Key into Utilmate

To connect and enter your publishable and secret keys, log into Utilmate and go to the Add On's screen in the Maintenance menu, System Configuration.  Click on the Stripe button.

Click on the connect button.

Paste your:

• publishable key into the public key field
• secret key into the private key field

and click connect.  Success!  You've now connected to Stripe and can start taking payments.