Skip to main content

Use the skills

You can follow the complete guided workflow or invoke an individual skill after you’ve completed its prerequisites.

Before you begin

Make sure you:

  1. Added the Commerce integration agent skills to your compatible AI coding agent.
  2. Opened the project that you want to configure or update.
  3. Have permission to create or modify files in the project.
  4. Prepare each review each proposed change before you accept it.
Attention

Keep your credentials private

Don’t paste certificate contents, private keys, access tokens, or production secrets into an AI conversation. Store sensitive values in an appropriate secrets manager or local environment file. Don’t commit your .env file, certificate, or private key to source control.

Complete a guided integration

Use the following skills in order for the complete guided workflow.

1. Prepare your project

Run:

Plaintext
/jpm-integrations-get-started

The skill asks what you’re building or migrating and confirms whether you’ve completed J.P. Morgan onboarding. It also checks whether your project contains the expected environment variables.

When needed, the skill can create a sample environment file or add missing variable names without overwriting values that already exist.

2. Configure OAuth authentication

After you prepare your project, run:

Plaintext
/jpm-oauth

The skill checks the required inputs and asks which environment and programming language you use. It then generates an authentication module in a location you approve.

The module signs a JSON Web Token, exchanges it for an access token, and reuses the access token until shortly before it expires.

3. Add a Commerce API integration

After authentication works, run:

Plaintext
/jpm-merchant-integrations

The skill asks you to select Checkout or Online Payments and describe what you’re building or migrating. It then uses the relevant reference material to guide the integration.

Current coverage includes:

  1. Checkout
  2. Online Payments
  3. Tokenization
  4. Standalone 3-D Secure
  5. Account Updater

Complete and test one API integration before you begin another.

Tip

Early access

Tokenization, standalone 3-D Secure, and Account Updater are early access capabilities. Complete additional testing and validation before you rely on them.

Use an individual skill

You can run a skill directly when you’ve already completed its prerequisites.

Merchant skill commands
What you want to do Command When to run it
Generate a Certificate Signing Request and private key for onboarding /jpm-csr Run this skill before onboarding if you need a Certificate Signing Request and private key for client ID provisioning.
Prepare your project and credentials /jpm-integrations-get-started Run this skill when you’re starting a J.P. Morgan integration or migrating from another payment provider.
Implement OAuth authentication /jpm-oauth Run this skill after you have the required onboarding credentials.
Add a supported Commerce API integration /jpm-merchant-integrations Run this skill after you’ve configured J.P. Morgan authentication.
Receive and verify webhook events /jpm-notifications Run this skill after you’ve configured OAuth and need to receive and verify webhook events.
Note

Early access

jpm-notifications is an early access skill. Complete additional testing and validation before you rely on it.

Ask your agent naturally

You can also describe your task in your own words.

For example:

Plaintext
Help me generate a Certificate Signing Request for J.P. Morgan onboarding.
Plaintext
Help me prepare this project for a J.P. Morgan Payments API integration.
Plaintext
Set up J.P. Morgan OAuth in this Node application.
Plaintext
Help me add J.P. Morgan Checkout to this application.
Plaintext
Help me receive and verify J.P. Morgan webhook events.

A compatible AI coding agent can load an installed skill when your request matches its purpose. Use the corresponding slash command when you want to specify which skill the agent uses.

Next steps