Navigating Your Account

There are several concepts that are important to understand when navigating your account and structuring your company’s access to Spreedly.

Logging in

To explore your account and manage your company’s access to Spreedly, log in here. If you’re having problems logging in, reset your password first, then contact us if you’re still experiencing difficulties.

Organizations

Every user on Spreedly belongs to an organization. If you registered for Spreedly directly (i.e., without an e-mail invitation from an existing organization member) you specified the organization name on the registration form.

An organization is meant to represent a complete company and its connected merchant accounts. Billing occurs at the organization level - if groups within your organization have separate billing requirements, they need to operate as independent organizations within Spreedly.

If you are logged into your account, you can change your organization’s name, and more, from the Organization tab.

Adding and removing users

Only add trusted users to your organization. All Spreedly users in your organization have administrator privileges - they can manage and access your list of API access secrets, remove users, cancel your organization’s Spreedly subscription, and take other actions.

To add a Spreedly user to your organization, go to the Organization tab when logged into your account. You can invite users via email by clicking the “Add User” button in the Administrators section. To remove a user from your account, you can click the “Remove” link next to their email address.

A note about removing users: Remoivng users from an organization prevents that user from accessing authenticated Spreedly websites. However, API access is granted via Access Secrets, which a removed user may have stored elsewhere. We recommend that you rotate Access Secrets when you remove users.

Environments

Each organization can have an unlimited number of environments. An environment allows you to separate your payment information into distinct groups. Note that all environments in paid Spreedly accounts have the capability to make production transactions - there are no test-only environments.

Environments are distinct and should be used to isolate separate payment functions. You cannot use a payment method stored in environment “A” in a purchase against a gateway from environment “B,” for example.

To use the Spreedly API, you must specify an environment key in your calls. An environment key is not sensitive information, so you may safely share it. To find your list of environment keys, visit the Environments tab when logged into your account.

Access secrets

Access secrets are used to authenticate your organization when using the Spreedly API. To view your organization’s access secrets, visit the Organization tab when logged into your account.

Any of your organization’s access secrets can authenticate API calls within any environment. Spreedly recommends using separate organizations to isolate production environments and data from non-production environments and data; the risk of using one organization for all of your environments is the production and test data are not properly segmented and production and non-production data are accessible via a common API access secret. Test and QA environments should not share credentials or secrets with production level environments, and the only way to do this is to create separate organizations. To completely segment a testing environment, we recommend creating a test organization in addition to your production organization.

Access secrets are considered private and secure. Do not share them or expose them to insecure channels - even in e-mails to the Spreedly team. An access secret, in combination with an environment key, grants full access to the Spreedly API. If you or another user within your organization share an access secret insecurely, we advise that you revoke the secret as soon as possible, and generate a new one.

Spreedly recommends rotating all access secrets every 60-90 days for stronger security. To prevent any downtime, follow these steps in order to rotate an access secret:

  1. Create a new access secret.
  2. Update your applications to use your new access secret instead of your original access secret.
  3. Once your applications have all been updated and the new access secret has been confirmed to work, log into your Spreedly account and delete the original access secret.

For more information on credentials and access secrets, visit our Credentials page.