proximity-reader

Enables iOS apps to accept contactless payments, loyalty cards, and ID verification via ProximityReader and Verifier APIs.

10|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/ios-agent/iosagent.dev --skill proximity-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proximity-reader
Source: https://github.com/ios-agent/iosagent.dev/tree/main/proximity-reader
Command: npx skills add https://github.com/ios-agent/iosagent.dev --skill proximity-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables your iOS app to accept contactless payments, loyalty cards, and verify IDs directly on an iPhone, eliminating the need for external hardware.

Core Features & Use Cases

  • Tap to Pay on iPhone: Process credit/debit card payments directly on your iPhone.
  • Loyalty & VAS: Read value-added service passes (like loyalty cards) from Apple Wallet.
  • ID Verification: Read mobile driver's licenses and national IDs using the Verifier API.
  • Store and Forward: Handle offline payment scenarios by storing transactions locally.
  • Use Case: A small business owner can use their iPhone to accept payments at a farmer's market, or a venue can verify a customer's age using their digital ID.

Quick Start

Use the proximity-reader skill to initiate a payment card read for a $29.99 purchase.

Frequently Asked Questions about proximity-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I accept contactless payments on iPhone without external hardware?

You can accept contactless payments on iPhone by using the ProximityReader framework to process credit and debit card transactions directly through Tap to Pay, eliminating the need for external terminals. It requires specific entitlements for secure NFC communication.

What is the Verifier API for mobile ID verification?

The Verifier API reads mobile driver's licenses and national IDs directly on an iPhone. It enables iOS applications to verify a customer's age or identity using digital documents without requiring external scanning hardware.

Can I read Apple Wallet loyalty cards using Tap to Pay on iPhone?

Yes, you can read Apple Wallet loyalty cards using the Value Added Services (VAS) feature within the ProximityReader framework. This allows your iOS app to accept contactless loyalty passes directly from a customer's device.

How do I handle offline contactless payment scenarios on iOS?

You can handle offline contactless payment scenarios on iOS using the Store and Forward feature. This stores the contactless payment transactions locally on the iPhone until network connectivity is restored for processing.

Do I need a Payment Service Provider to use Tap to Pay on iPhone?

Yes, you need to integrate with a Payment Service Provider (PSP) to process Tap to Pay on iPhone transactions. The ProximityReader framework reads the contactless payment data, but the PSP handles the actual transaction processing.