axiom-payments
axiom-payments guides you through integrating real-world payment methods—Apple Pay on native apps and websites, contactless card acceptance via Tap to Pay on iPhone, Wallet passes for tickets and loyalty cards, and post-purchase order tracking. It clarifies when to use Apple Pay versus in-app purchase, covers merchant setup and certificates, and routes you to solutions for payment rejections and sandbox testing.
axiom-payments helps you add Apple Pay, Wallet passes, Tap to Pay, and order tracking to accept real-world payments.
AI-generated summary based on this skill's SKILL.md
Install
CharlesWiltgen/Axiom/axiom-payments · repository language: Go
git clone https://github.com/CharlesWiltgen/Axiom
cp -r Axiom/axiom-codex/skills/axiom-payments ~/.claude/skills/axiom-paymentsFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I add Apple Pay to my iOS app?
axiom-payments walks you through integrating Apple Pay into native iOS applications. The process involves requesting the Apple Pay entitlement, configuring merchant identity certificates, implementing PKPaymentRequest to specify payment networks and required fields, and handling the PKPaymentAuthorizationViewController delegate callbacks. axiom-payments covers sandbox testing setup, merchant validation server requirements, and common integration pitfalls that lead to App Review rejections.
Should I use Apple Pay or in-app purchase for my use case?
axiom-payments clarifies the distinction: use Apple Pay for physical goods, services, and donations where real-world payment acceptance is needed; use in-app purchase exclusively for digital content and app features. Apple Pay works on both iOS apps and websites, supports contactless card readers via Tap to Pay on iPhone, and integrates with Wallet for order tracking. In-app purchase is restricted to App Store–managed transactions and cannot accept external payment methods.
How do I set up wallet passes for event tickets?
axiom-payments guides you through creating and signing PKPass files for Wallet integration. You'll generate a pass type ID certificate, configure PKCS#7 signing with your certificate and private key, structure the pass JSON with event details and barcodes, and serve the .pkpass file with the correct MIME type. axiom-payments covers domain verification requirements, pass updates post-purchase, and troubleshooting import failures when passes won't load into Wallet.
What's required to implement Tap to Pay on iPhone?
axiom-payments outlines the setup for contactless card acceptance via Tap to Pay on iPhone. You need the com.apple.developer.proximity-reader entitlement, a compatible iPhone model (XS or later), merchant credentials, and implementation of the ProximityReader framework. axiom-payments addresses common delays in entitlement approval, sandbox testing procedures, and integration with your payment processor to complete transactions without external hardware.
Why isn't my Apple Pay button showing on my website?
axiom-payments troubleshoots web Apple Pay visibility issues. Common causes include incomplete domain verification (Apple Pay requires HTTPS and a valid merchant domain), missing ApplePaySession initialization, or incorrect button markup. axiom-payments guides you through verifying your domain via .well-known/apple-developer-merchantid-domain-association, checking merchant validation server responses for 503 errors, and ensuring your payment processor supports web Apple Pay.
How do I handle post-purchase order tracking in Wallet?
axiom-payments explains Orders in Wallet, which lets you send order updates directly to customers' Wallet app after purchase. You create an order pass, configure push notifications with order status changes, and use Apple's order management API to sync delivery and return information. axiom-payments covers pass signing, server-to-Wallet communication setup, and best practices for loyalty card integration alongside order tracking.
SKILL.md
rendered from the published skill — quoted content, verbatim
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
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 14 files
axiom-codex/skills/axiom-payments/SKILL.md
axiom-codex/skills/axiom-payments/agents/openai.yaml
axiom-codex/skills/axiom-payments/skills/apple-pay-ref.md
axiom-codex/skills/axiom-payments/skills/apple-pay-vs-iap.md
axiom-codex/skills/axiom-payments/skills/apple-pay-web-ref.md
axiom-codex/skills/axiom-payments/skills/apple-pay-web.md
axiom-codex/skills/axiom-payments/skills/apple-pay.md
axiom-codex/skills/axiom-payments/skills/payments-diag.md
axiom-codex/skills/axiom-payments/skills/tap-to-pay-ref.md
axiom-codex/skills/axiom-payments/skills/tap-to-pay.md
axiom-codex/skills/axiom-payments/skills/wallet-extensions-ref.md
axiom-codex/skills/axiom-payments/skills/wallet-orders.md
axiom-codex/skills/axiom-payments/skills/wallet-passes-ref.md
axiom-codex/skills/axiom-payments/skills/wallet-passes.md