Establishing a Connection
Creating a JDBC Data Source
You can create a JDBC data source to connect from your Java application. Creating a JDBC data source based on the CData JDBC Driver for Stripe consists of three basic steps:
- Add the driver JAR file to the classpath. The JAR file is located in the lib subfolder of the installation directory. Note that the .lic file must be located in the same folder as the JAR file.
- Provide the driver class. For example:
cdata.jdbc.stripe.StripeDriver
- Provide the JDBC URL. For example:
jdbc:stripe:InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;CallbackURL=http://localhost:33333; or jdbc:cdata:stripe:InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;CallbackURL=http://localhost:33333;
The second format above can be used whenever there is a conflict in your application between drivers using the same URL format to ensure you are using the CData driver. The URL must start with either "jdbc:stripe:" or "jdbc:cdata:stripe:" and can include any of the connection properties in name-value pairs separated with semicolons.
Connecting to Stripe
You can optionally set the following to refine the data returned from Stripe.
- AccountId: Set this to the Connected Account Id which you would like to get data for. To get the account Id, navigate to the stripe dashboard and click on connected accounts from the left hand menu. You can get the account id from the connected accounts list.
Authenticating to Stripe
Stripe supports both the OAuth authentication standard, and authenticating with an API Key.
Live API Key
Set the AuthScheme to APIKey. From the Stripe dashboard, navigate to Developers --> API keys --> Secret key --> Reveal live API Key and set LiveAPIKey to this value.
OAuth
InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken. .
AuthScheme - Set this to OAuth.
CData embeds an OAuth application into the driver so you can connect without setting any connection properties for your user credentials. When you connect, the driver opens the OAuth endpoint in your default browser. Log in and grant permissions to the application. The driver then completes the OAuth process. For more information on the Embedded Credentials or information on creating a custom OAuth application, refer to our Using OAuth Authentication guide.