Resources
Comprehensive resources for developing Tap to Pay on iPhone applications with Netevia and Apple's payment technologies.
Apple Resources
Essential resources from Apple for working with Tap to Pay on iPhone technology.
ProximityReader Framework
The ProximityReader framework provides the core functionality for reading contactless payment cards on iPhone.
| Resource | Description | Link |
|---|---|---|
| ProximityReader Framework Documentation | Complete framework reference including setup steps, API documentation, and implementation guides for integrating Tap to Pay on iPhone | View Documentation |
| Quick Start Guide | Step-by-step guide to begin using Tap to Pay on iPhone to read contactless payment cards | Developer Documentation |
| Framework Reference | Complete API reference for all ProximityReader classes, methods, and properties | API Reference |
Key Topics Covered:
- Reader initialization and configuration
- Card reading and payment processing
- Error handling and recovery
- Security and entitlement requirements
- Session management and lifecycle
Apple Business Register Documentation
Comprehensive documentation portal for Payment Service Providers (PSPs) working with Tap to Pay on iPhone.
| Resource | Description | Link |
|---|---|---|
| Apple Business Register | Central hub for PSP-specific Tap to Pay on iPhone documentation, including registration, certification, and integration guides | Apple Business Register |
| PSP Integration Guide | Complete integration guide for Payment Service Providers | [For PSPs only] |
| Certification Process | Step-by-step certification requirements and procedures | Apple Business Register |
Note: Apple Business Register documentation is available for Payment Service Providers (PSPs) only. Partners are not becoming PSPs — Netevia remains the PSP and is responsible for the payment-side setup and processing relationship. Partners do not need to complete PSP-level onboarding.
Human Interface Guidelines
Apple's design guidelines and best practices for Tap to Pay on iPhone applications.
| Resource | Description | Link |
|---|---|---|
| Tap to Pay Human Interface Guidelines | Design principles, UI/UX best practices, and accessibility guidelines specifically for Tap to Pay on iPhone applications | View Guidelines |
| Design Patterns | Recommended UI patterns and components for payment flows | Human Interface Guidelines |
| Accessibility Guidelines | VoiceOver, Dynamic Type, and other accessibility requirements | Accessibility Guide |
Key Topics Covered:
- User interface design principles
- Payment flow UX best practices
- Error handling and user feedback
- Accessibility compliance
- Branding and messaging guidelines
Merchant Education
Educational materials and training resources for PSPs and app developers.
| Resource | Description | Link |
|---|---|---|
| Accept Payments Guide | Comprehensive guide on how to accept payments using Tap to Pay on iPhone, including merchant setup, training materials, and best practices | View Guide |
| Merchant Training Materials | Educational resources for training merchants on using Tap to Pay | Merchant Education |
| Developer Resources | Developer-focused educational content and implementation guides | Developer Resources |
Key Topics Covered:
- Merchant onboarding process
- Payment acceptance workflows
- Device setup and configuration
- Troubleshooting common issues
- Training and support materials
Tap to Pay on iPhone FAQs
Frequently asked questions and answers about Tap to Pay on iPhone technology.
| Resource | Description | Link |
|---|---|---|
| Tap to Pay FAQs | Comprehensive FAQ covering common questions about Tap to Pay on iPhone implementation, requirements, and troubleshooting | View FAQs |
| Technical FAQs | Technical implementation questions and answers | Apple Business Register |
| Integration FAQs | Common integration questions and solutions | Apple Business Register |
Common Topics:
- Device requirements and compatibility
- Entitlement and certification questions
- Integration and implementation queries
- Security and compliance questions
- Troubleshooting and support
Additional Apple Resources
| Resource | Description | Link |
|---|---|---|
| WWDC Sessions | Video sessions from Apple's Worldwide Developers Conference covering Tap to Pay and payment technologies | WWDC Videos |
| Apple Developer Forums | Community forums for discussing Tap to Pay implementation and troubleshooting | Developer Forums |
| Apple Developer Support | Direct support channels for Apple Developer Program members | Developer Support |
| Security Documentation | Apple's security guidelines and best practices for payment applications | Security Guide |
Netevia Documentation
API Documentation
| Resource | Description | Link |
|---|---|---|
| REST API Reference | Complete API documentation with examples, request/response schemas, and authentication details | API Reference |
| Webhook Documentation | Webhook setup guide, event reference, and testing procedures | Webhook Guide |
| API Authentication | Authentication methods, API keys, and security best practices | API Reference |
SDK Documentation
| Resource | Description | Link |
|---|---|---|
| iOS SDK Guide | Complete iOS SDK integration guide with code examples | Setting Up the Entitlement |
| SDK Installation | Step-by-step installation instructions for iOS SDK | Installing SDK |
| Payment Lifecycle | Complete guide to payment processing and lifecycle management | Payment Lifecycle |
| Tap to Pay Configuration | Guide to adding Tap to Pay functionality to your iOS app | Tap to Pay Guide |
Integration Guides
| Resource | Description | Link |
|---|---|---|
| Getting Started | Complete getting started guide for new Netevia integrations | Introduction |
| Merchant Setup | Merchant setup and production configuration are coordinated by Netevia during partner onboarding. | |
| Batch Settlements | Guide to batch processing and settlement workflows | Batch Settlements |
| Webhook Integration | Complete webhook integration guide with examples | Webhook Setup |
Developer Resources
| Resource | Description | Link |
|---|---|---|
| Code Examples | Sample implementations in Swift, Objective-C, and other languages | Code Examples |
| Sandbox Environment | Test environment setup and configuration guide | Introduction |
| Best Practices | Apple best practices and development guidelines | Apple Best Practices |
| Security Guidelines | Security best practices and Apple development guidelines | Security Guide |
SDK Downloads
iOS SDK
# CocoaPods
pod 'NeteviaSDK'
# Swift Package Manager
https://github.com/netevialabs/netevia-ios
Android SDK
// Add to build.gradle
implementation 'com.netevia:netevia-android-sdk:1.0.6'
Testing Resources
Test Cards
Use these test card numbers to verify your Tap to Pay integration in the Certificate environment. These cards simulate different payment scenarios without processing real transactions.
| Card Type | Number | CVV | Expiry | Use Case |
|---|---|---|---|---|
| Visa | 4242 4242 4242 4242 | 123 | Any future date | Successful payment testing |
| Mastercard | 5555 5555 5555 4444 | 123 | Any future date | Successful payment testing |
| American Express | 3782 822463 10005 | 1234 | Any future date | Successful payment testing |
| Discover | 6011 1111 1111 1117 | 123 | Any future date | Successful payment testing |
Test Scenarios
Test various payment scenarios using these test card numbers:
| Scenario | Card Number | Expected Result |
|---|---|---|
| Successful Payment | Use any test card above with valid details | Payment processes successfully |
| Declined Payment | 4000 0000 0000 0002 | Payment is declined |
| Insufficient Funds | 4000 0000 0000 9995 | Transaction fails due to insufficient funds |
| Invalid CVV | Any test card with wrong CVV | CVV validation error |
| Expired Card | Any test card with past expiry date | Card expiration error |
Testing Environment
| Environment | Description | Use Case |
|---|---|---|
| Certificate (CERT) | Test environment for development | Use for all internal testing and development |
| Production | Live merchant transaction environment | Use only after thorough testing and certification |
Important: Always use the Certificate environment for testing. Test cards work only in the Certificate environment and will not process real transactions.
Testing Checklist
Before deploying to production, ensure you've tested:
- Successful payment processing with all card types
- Error handling for declined payments
- Error handling for invalid card details
- Reader availability checking
- Entitlement verification
- Payment flow UI/UX
- Error messaging and user feedback
- Accessibility compliance (VoiceOver, Dynamic Type)
- Network error handling
- Background/foreground transitions
Support
Netevia is the first-line contact for partner Tap to Pay integrations.
Partners should contact Netevia first for integration, merchant setup, production launch, or payment-side questions. See Support & Escalation for the full support model, what to include in a support request, priority guidelines, and the escalation path.
| Resource | Description | Link |
|---|---|---|
| Support & Escalation | Partner support model, request contents, priority guidelines, and escalation path | Support & Escalation |
| Partner Onboarding Overview | How the partner integration model works and the high-level launch flow | Partner Onboarding |
| SDK Access & Distribution | How partners receive SDK access and how releases are distributed | SDK Access |
| UAT Checklist | Validate the integration before production launch | UAT Checklist |
| Production Launch Checklist | Confirm production readiness and coordinate launch with Netevia | Launch Checklist |
