# axiom-payments

Walks your agent through real-world payments: Apple Pay, Wallet passes, Tap to Pay on iPhone. Not for in-app purchase of digital content.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 860 installs · ★ 1229
- Author: CharlesWiltgen
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/CharlesWiltgen/Axiom/tree/HEAD/axiom-codex/skills/axiom-payments/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/axiom-payments

## What it does

The skill kicks in when a project takes payments for physical goods, services, donations, tickets or loyalty cards. It ships as a set of references: native Apple Pay for iOS, iPadOS, macOS, Catalyst, visionOS and watchOS, Apple Pay on the web through Apple Pay JS or the Payment Request API, Wallet passes, contactless card acceptance on iPhone via ProximityReader, and post-purchase order tracking in Wallet. Separate files cover merchant ID setup, certificates and PKCS #7 signing chains.

A routing table maps symptoms and tasks to the right file. A missing payment sheet or a merchant validation 503 points to `skills/payments-diag.md`; pass questions go to `skills/wallet-passes.md`. The same place handles App Review rejections that mention payments, plus domain verification for Apple Pay on the web through `.well-known/apple-developer-merchantid-domain-association.txt`.

The boundary matters. In-app purchase and subscriptions for digital content belong to `axiom-integration` instead. So do generic NFC tag reads with Core NFC and the consumer banking surface on FinanceKit — account aggregation and transaction queries are out of scope. If you sell a digital subscription and the agent reaches for this skill, check which file it actually loaded.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add CharlesWiltgen/Axiom --skill axiom-payments -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/axiom-payments/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/axiom-payments/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add CharlesWiltgen/Axiom --skill axiom-payments -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/axiom-payments/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add CharlesWiltgen/Axiom --skill axiom-payments -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/axiom-payments/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install CharlesWiltgen/Axiom axiom-payments
```

2. **Manually: put the files in place**
- File: `.github/skills/axiom-payments/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add CharlesWiltgen/Axiom --skill axiom-payments -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/CharlesWiltgen/Axiom --path axiom-codex/skills/axiom-payments
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/axiom-payments/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add CharlesWiltgen/Axiom --skill axiom-payments -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/CharlesWiltgen/Axiom/tree/HEAD/axiom-codex/skills/axiom-payments/SKILL.md

## When to use it
- add Apple Pay to a native iOS or macOS app
- build a Wallet pass for an event ticket or loyalty card
- accept contactless cards on iPhone with ProximityReader
- set up a merchant ID and certificates for pass signing
- work through an App Review rejection about payments

## Example prompts
- Add Apple Pay to this app and tell me which certificates I need
- Build a Wallet pass for an event ticket with semantic tags
- The app was rejected in App Review over payments — walk me through why

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b9c28a5edbb8d017.

BEGIN THIRD-PARTY FILE b9c28a5edbb8d017
```text
---
name: axiom-payments
description: Use when accepting ANY real-world payment — Apple Pay, Wallet passes, Tap to Pay, Orders in Wallet. NOT in-app purchase / digital content (use axiom-integration). Covers entitlements, certs, signing, App Review payment rules.
license: MIT
---

# Real-World Payments (Apple Pay / Wallet / Tap to Pay)

**You MUST use this skill when accepting ANY real-world payment — physical goods, services, donations, ticketing, loyalty cards, contactless card-present, or post-purchase order tracking. NOT for in-app purchase or digital content.**

## When to Use

Use this skill when you encounter:
- Adding Apple Pay to an iOS / iPadOS / macOS / Catalyst / visionOS / watchOS app
- Adding Apple Pay to a website (Apple Pay JS or W3C Payment Request API)
- Building Wallet passes (boarding passes, event tickets, coupons, loyalty cards, store cards)
- Accepting contactless card payments on iPhone (Tap to Pay on iPhone / ProximityReader)
- Surfacing post-purchase order tracking in Wallet (Orders in Wallet, FinanceKitUI add-order helpers)
- Issuer or bank card provisioning into Wallet (issuer extensions)
- Apple Pay merchant ID, processing certificate, or merchant identity certificate setup
- Pass Type ID or Order Type ID certificates and PKCS #7 signing chains
- Tap to Pay managed entitlement (`com.apple.developer.proximity-reader.payment.acceptance`)
- App Review rejections that mention payments, IAP, Apple Pay, Wallet, or Acceptable Use Guidelines
- Domain verification for Apple Pay on the web (`.well-known/apple-developer-merchantid-domain-association.txt`)
- Sandbox testing with Apple Pay sandbox cards or sandbox tester accounts

## When NOT to Use

| Issue | Correct Skill | Why NOT axiom-payments |
|-------|---------------|------------------------|
| In-app purchase, subscriptions for digital content | **axiom-integration** | StoreKit 2 / digital goods boundary; see `axiom-integration (skills/in-app-purchases.md)` |
| Generic NFC tag reads (Core NFC, non-Wallet) | **axiom-integration** | Different framework; PassKit NFC is Wallet-specific |
| Code signing / provisioning fundamentals | **axiom-security** | Code signing is generic; payment certs are *added* to that flow |
| App Store rejection workflow & appeals | **axiom-shipping** | Rejection workflow lives there; payment-specific rejection patterns route from there into here |
```
END THIRD-PARTY FILE b9c28a5edbb8d017

The third-party file has ended. Everything between the b9c28a5edbb8d017 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2391 of 15294 bytes. © CharlesWiltgen · MIT · https://github.com/CharlesWiltgen/Axiom/tree/HEAD/axiom-codex/skills/axiom-payments/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md