J.P. Morgan Payments Developer Portal — Merchant Integrations Agent Skills

A set of Agent Skills that give GitHub Copilot, Claude Code, Cursor, and other Agent harnesses procedural knowledge of J.P. Morgan's Payments Developer Portal (PDP) APIs. They provide a conversational experience that walks you from getting started with J.P. Morgan Payments APIs to integrating with new ones and expanding your integration — without you having to re-read the docs.

Disclaimer

Use at Your Own Risk. The code and instructions provided in this repository are intended for reference purposes only. The maintainers of this repository do not assume any responsibility for any issues, damages, or losses that may arise from the use of this code or instructions.

These skills rely on AI agents to produce code, and all generated code must be reviewed and verified by a qualified engineer before being deployed to production. AI-generated code can contain subtle correctness, security, or compliance defects.

Early access. Account Updater, Tokenization, 3-D Secure, and jpm-notifications are early access — expect to do additional testing and validation before relying on them.

What's Inside

This repository ships three Agent Skills that chain together, plus two more you can use on their own: the standalone jpm-csr onboarding helper (generate a CSR) and jpm-notifications, a companion to jpm-merchant-integrations for receiving inbound webhook events.

Skill	Path	Purpose
`jpm-integrations-get-started`	`skills/jpm-integrations-get-started/`	Get started with J.P. Morgan Payments — disclaimer acknowledgment, goal triage, credential check, and `.env` setup
`jpm-oauth`	`skills/jpm-oauth/`	Generates a working OAuth (JWT signing + IDAnywhere token exchange) module in your project, with token caching baked in
`jpm-merchant-integrations`	`skills/jpm-merchant-integrations/`	Walks you through one API integration at a time — Checkout or Online Payments — and helps you expand by adding new APIs over time
`jpm-csr`	`skills/jpm-csr/`	Standalone onboarding helper (independent of the chain above) — generates a Certificate Signing Request (CSR) + private key to send to your J.P. Morgan Relationship Manager for client ID provisioning. Run it before onboarding if you don't yet have credentials
`jpm-notifications`	`skills/jpm-notifications/`	Companion to `jpm-merchant-integrations` — receive and verify inbound JPM webhook events (signature verification, optional mTLS, de-duplication) instead of polling. Assumes auth is already set up via `jpm-oauth`

Each skill folder is composed of three layers:

Layer	Path	Purpose
SKILL.md	`SKILL.md`	Entry point — the playbook the agent follows
References	`references/`	Per-API deep dives with flow diagrams, endpoint tables, field constraints, and sample requests
Examples / Templates / Scripts	`examples/`, `templates/`, `scripts/`	Reference samples and helpers the skill points to during execution

API Coverage

API	Reference File	What It Covers
Checkout	`skills/jpm-merchant-integrations/references/checkout.md`	Drop-in UI, Hosted Payments Page, checkout sessions, capture methods, field constraints
Online Payments	`skills/jpm-merchant-integrations/references/online-payments.md`	Full payment lifecycle (auth, capture, void, refund), card / wallet / APM methods, inline 3-D Secure
Tokenization	`skills/jpm-merchant-integrations/references/tokenization.md`	Swap a card PAN for a merchant-scoped token to reduce PCI scope and store tokens instead of card data
3-D Secure (Standalone)	`skills/jpm-merchant-integrations/references/3d-secure.md`	Standalone 3DS authentication (use the inline `threeDS` field in Online Payments when bundling with an auth)
Account Updater	`skills/jpm-merchant-integrations/references/account-updater.md`	Keep stored cards current as issuers reissue them — inquiry mode (sync) or card-registration mode (async, via `jpm-notifications`)

More APIs (Reporting and others) are planned for future releases.

Installation

The skills are written in the open Agent Skills format and load in any compatible Agent harness. Below are the install paths:

Skills CLI

npx skills detects your Agent harness and installs into the right directory automatically:

npx skills add jpmorgan-payments/pdp-skills

Claude Code

The fastest path is the Claude Code plugin manager — this repository ships as a plugin with a marketplace manifest at the root.

Plugin install

Inside Claude Code, run:

/plugin marketplace add https://github.com/jpmorgan-payments/pdp-skills
/plugin install jpm-payments-skills@jpm-payments-skills

After install, run /plugin to confirm it's listed and /skills to see the three jpm-* skills.

To update later:

/plugin update jpm-payments-skills

Manual install

If you'd rather copy the skills directly into your project, Claude Code auto-discovers any skills under .claude/skills/:

git clone https://github.com/jpmorgan-payments/pdp-skills /tmp/jpm-skills
mkdir -p .claude/skills
cp -r /tmp/jpm-skills/skills/jpm-* .claude/skills/

For a user-level install (every Claude Code project sees the skills), copy into ~/.claude/skills/ instead.

GitHub Copilot

GitHub Copilot automatically discovers skills placed in .github/skills/ at the root of your repository. No extra configuration is needed.

git clone https://github.com/jpmorgan-payments/pdp-skills /tmp/jpm-skills
mkdir -p .github/skills
cp -r /tmp/jpm-skills/skills/jpm-* .github/skills/

Open your project in VS Code or a JetBrains IDE with GitHub Copilot Chat enabled, then start asking questions. Copilot loads the relevant skill automatically when your prompt matches the skill's description field.

Tip: You can invoke a skill explicitly via its slash command (for example, /jpm-integrations-get-started, /jpm-oauth, or /jpm-merchant-integrations) — works the same in both Claude Code and GitHub Copilot. Otherwise, any prompt that matches the skill's description field triggers it automatically.

Usage

Full walkthrough (recommended)

Start with the first skill — it hands off automatically through the full sequence:

/jpm-integrations-get-started

jpm-integrations-get-started → jpm-oauth → jpm-merchant-integrations

Individual skills

Goal	Slash command
Generate a CSR + private key for onboarding	`/jpm-csr`
Onboarding & `.env` setup	`/jpm-integrations-get-started`
Generate OAuth module	`/jpm-oauth`
Integrate Checkout or Online Payments	`/jpm-merchant-integrations`
Receive & verify webhook events	`/jpm-notifications`

Each skill checks its own prerequisites and will tell you what to run first if anything is missing.

Repo Structure

.
├── .claude-plugin/                   # Claude Code plugin manifest + marketplace listing
│   ├── plugin.json
│   └── marketplace.json
├── .github/
│   └── workflows/                    # daily GitHub traffic-metrics collection
├── skills/                           # the three agent skills
│   ├── jpm-integrations-get-started/
│   ├── jpm-oauth/
│   └── jpm-merchant-integrations/
├── LICENSE
└── README.md

Contributing to JPMC Projects

Only valid contributors are able to provide contributions to this repository.

If this is your first time contributing to JPMC codebases you will need to fill out our Contribution Licence Agreement (CLA). More information can be found at: https://github.com/jpmorganchase/.github/blob/main/CONTRIBUTING.md

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.