Save and Reuse Payment Methods Payment System

A comprehensive multi-language demonstration of wallet one-click payment processing using the Global Payments SDK. This example showcases secure payment method storage, multi-use token creation with integrated customer data, and streamlined payment processing across multiple programming languages.

• Multi-Use Token Creation - Convert single-use tokens to stored payment tokens with customer data integration
• Payment Method Management - Store, retrieve, edit, and manage customer payment methods securely
• One-Click Payment Processing - Process immediate charges ($25) using stored payment methods
• Customer Data Integration - Associate billing information directly with payment tokens
• Real-Time Processing - Immediate transaction processing with live API integration

• Mock Mode Support - Test payment flows with simulated responses without hitting live APIs
• Test Card Integration - Built-in Global Payments test cards for development
• Comprehensive Web Interface - Complete UI with payment method management and transaction processing
• Global Payments SDK Integration - Secure tokenization using hosted payment fields

• Consistent API Structure - Identical endpoints and functionality across all language implementations
• JSON-Based Storage - Simple file-based persistence for payment methods and customer data
• Environment Configuration - Secure credential management with .env files
• Health Monitoring - System status endpoints for monitoring and debugging

Each implementation provides identical functionality with language-specific best practices:

• Global Payments SDK Integration - Secure tokenization with hosted payment fields
• Responsive Web Interface - Complete payment management UI
• Test Card Helper - Integrated Global Payments test cards
• Real-Time Validation - Client-side form validation and error handling

• RESTful API Design - Consistent endpoints across all implementations
• Multi-Use Token Creation - Secure conversion of single-use to stored payment tokens
• Customer Data Storage - Integrated billing information with payment methods
• Mock Mode Capability - Simulated responses for development and testing

• Global Payments account with API credentials (Sign up here)
• Development environment for your chosen language
• Package manager (npm, composer, maven, dotnet, go mod)

1. Clone the repository

   git clone <repository-url>
   cd portico-save-and-reuse-payment-methods

2. Choose your implementation

   cd nodejs  # or php, java, go, dotnet

3. Configure environment

   cp .env.sample .env
   # Edit .env with your Global Payments credentials:
   # PUBLIC_API_KEY=pk_test_xxx
   # SECRET_API_KEY=sk_test_xxx

4. Install dependencies and run

   ./run.sh

   Or manually for each language:

   # Node.js
   npm install && npm start
   
   # PHP
   cd php && ./run.sh
   
   # Java
   mvn clean compile cargo:run
   
   # Go
   go mod download && go run .
   
   # .NET
   dotnet restore && dotnet run

5. Access the application Open http://localhost:8000 in your browser

Each implementation includes a mock mode that allows you to:

• Test payment flows without live API calls
• Use simulated responses for consistent testing
• Develop and debug without API costs
• Toggle between mock and live modes via the UI

Built-in Global Payments test cards:

• Visa: 4012002000060016
• MasterCard: 2223000010005780, 5473500000000014
• Discover: 6011000990156527
• American Express: 372700699251018
• JCB: 3566007770007321

All test cards use:

• Expiry: 12/2028
• CVV: 123 (1234 for Amex)

The system includes pre-filled customer information for testing:

• Name: Jane Doe
• Email: jane.doe@example.com
• Phone: 5551112222
• Address: 1 Example Way, Jeffersonville, IN 47130, USA

1. Customer Information - Collect name, email, phone, and billing address
2. Payment Details - Secure tokenization using Global Payments SDK
3. Multi-Use Token Creation - Convert single-use token to multi-use token with customer data
4. Storage - Save payment method with optional nickname and default status

1. Method Selection - Choose from stored payment methods
2. One-Click Processing - Immediate $25 charge processing
3. Real-Time Results - Live transaction status and details
4. Transaction History - Complete transaction information display

Each implementation provides a solid foundation for:

• Custom Payment Amounts - Modify charge amounts and currency
• Additional Payment Types - Add authorization/capture, refunds, voids
• Enhanced Customer Management - Expand customer data fields
• Subscription Processing - Recurring payment capabilities
• Advanced Reporting - Transaction history and analytics

Before deploying to production:

• Security: Implement proper input validation and sanitization
• Logging: Add comprehensive logging and monitoring
• Error Handling: Enhance error handling and user feedback
• Database: Replace JSON storage with production database
• Authentication: Add user authentication and authorization
• Compliance: Ensure PCI DSS compliance measures

• PCI Compliance — globalpayments.js hosted fields handle card data client-side; your server never sees raw card numbers
• Token-Based Processing — All payments use multi-use tokens, not card data
• Credential Isolation — Store API keys in .env files, never commit to version control
• HTTPS Required — Always use TLS in production environments
• Input Validation — Validate and sanitize all user input server-side
• JSON Storage Limitation — File-based storage is for demo only; use an encrypted database in production

Each language implementation includes detailed documentation:

• Setup Instructions - Environment configuration and dependencies
• API Documentation - Endpoint specifications and examples
• Code Structure - File organization and architecture
• Troubleshooting - Common issues and solutions
• Recent Updates - Bug fixes and improvements

• ✅ Unified API Structure - Consistent endpoints across all implementations
• ✅ Payment Token Handling - Fixed frontend/backend data structure alignment
• ✅ Customer Data Integration - Standardized customer information collection
• ✅ Mock Mode Functionality - Consistent testing capabilities

• ✅ Java: Fixed compilation errors with Global Payments SDK v14.2.20
• ✅ Node.js: Corrected payment token field naming (paymentToken vs payment_token)
• ✅ Frontend: Updated payment data structure for backend compatibility
• ✅ Go: Enhanced frontend to match PHP implementation functionality

This project serves as a comprehensive example for Global Payments SDK integration. When contributing:

• Maintain consistency across all language implementations
• Follow each language's best practices and conventions
• Ensure thorough testing with both mock and live modes
• Update documentation to reflect any changes

This project is provided as an educational example for Global Payments SDK integration. Please review the license file for specific terms and conditions.

• Global Payments Developer Portal
• API Reference
• Test Cards
• PHP SDK
• Node.js SDK
• Java SDK
• .NET SDK

• 🌐 Developer Portal — developer.globalpayments.com
• 💬 Discord — Join the community
• 📋 GitHub Discussions — github.com/orgs/globalpayments/discussions
• 📧 Newsletter — Subscribe
• 💼 LinkedIn — Global Payments for Developers

Have a question or found a bug? Open an issue or reach out at communityexperience@globalpay.com.