2 Before You Install the Recipe

You must perform the following configuration tasks on your Stripe and Slack instances in order to successfully connect to these external systems using Oracle Integration and post notification messages in Slack for successful Stripe charges.

Configure Stripe

To access the Stripe instance from Oracle Integration, you must perform certain configurations on your Stripe instance.

1. Retrieve the API key associated with your Stripe account.
   1. Log in to your Stripe instance as an administrator.
   2. In the left navigation pane, click Developers, then API keys. The API keys page is displayed with all the keys associated with your account.
   3. In the Standard keys section, click Reveal test key in the Secret key row.
   4. Note the secret key.
2. Configure webhooks in your Stripe account. To register a webhook endpoint, see Add a webhook endpoint.
   • In the Endpoint URL field, enter your Oracle Integration endpoint URL. For example, https://<encodedUsername>:<encodedPassword>@<host>/ic/api/integration/v2/flows/rest/project/ ORCL-R-STRIPE_SLACK_CHARGE_NOTIF/ORCL-R-STRIPE_SLACK_CHARGE_NOTIF/1.0/.
   • In the Select events field, select charge.succeeded.

Configure Slack

Complete the following tasks in your Slack instance to successfully connect to it using Oracle Integration and post notification messages.

1. Create a Slack app and configure it to receive notifications for successful Stripe charges.
   1. Log in to the Slack app platform at https://api.slack.com.
   2. From the workspace navigation menu, click your workspace.
   3. Select Administration and then select Manage apps.
   4. In the Slack app directory page, click Build.
   5. Click Create an App, and in the resulting Create an app dialog, select From scratch.
   6. In the Name app & choose workspace dialog, enter the following details.

      Field	Information to Enter
      App Name	Enter the name of your app. For example, Oracle Integration App.
      Pick a workspace to develop your app in	Select your workspace from the drop-down list.

   7. Click Create App.
      The app gets created and its Basic Information page appears.
   8. Get the Slack App API credentials. In the app's Basic Information page, scroll down to the App Credentials section. Note the client ID in the Client ID field, and the client secret in the Client Secret field.
      These API credentials, that is the client ID and secret, were automatically generated when you created the app. You'll use these later while configuring connections to your Slack instance from Oracle Integration.
   9. Set permission and scope for your Slack App. In the left menu, under Features, select OAuth & Permissions.
   10. In the OAuth & Permissions page, go to the Redirect URLs section.
   11. Click Add New Redirect URL and enter the URL of your Oracle Integration instance. For example, https://your_instance_URL:443/icsapis/agent/oauth/callback, where your_instance_URL is the Host URL of your Oracle Integration instance.
   12. Click Add, and then click Save URLs.
   13. Scroll to the Scopes section, and under User Token Scopes click Add an OAuth Scope.
   14. Enter chat:write.
   15. Press Enter.
2. Get the channel ID of the channel that you created on your Slack workspace. You'll use the channel ID for configuring the integration properties in Oracle Integration, so that notifications are sent to the right Slack channel.
   1. On your Slack workspace, navigate to the channel under Channels in the left navigation pane.
   2. Right-click the channel name.
   3. In the menu that displays, click Copy link.
   4. Copy the link to a text editor, such as Notepad.
   5. Note the nine characters after the last forward slash (/) in the link. This is the channel ID of the Slack channel.
      Note that the channel ID can be a combination of letters and numbers. For example, CB64YSB2D.