Global Payments SDK Starter Template

This starter template provides a customizable foundation for Global Payments SDK integration across multiple programming languages. Each implementation includes basic SDK setup, configuration management, and placeholder endpoints that you can modify for your specific payment use cases.

Available Implementations

• .NET Core - ASP.NET Core web application
• Go - Go HTTP server application
• Java - Jakarta EE servlet-based web application
• Node.js - Express.js web application
• PHP - PHP web application
• Python - Flask web application

Template Features

• SDK Configuration - Basic setup with environment variables
• Placeholder Endpoints - Ready-to-customize API endpoints
• Error Handling - Basic error handling structure
• Client Integration - HTML form with hosted fields tokenization
• Multiple Languages - Consistent structure across all implementations

Customization Options

Each template includes:

1. Basic SDK Setup

   • Environment variable configuration
   • Service URL configuration
   • API key management

2. Starter Endpoints

   • GET /config - Configuration endpoint
   • POST /process-payment - Payment processing template
   • Commented examples for additional endpoints (authorize, capture, refund, etc.)

3. Ready-to-Modify Structure

   • TODO comments for customization points
   • Example payment logic you can adapt
   • Placeholder functions for various payment flows

Quick Start

1. Copy the template - Copy this directory to start your new project
2. Choose your language - Navigate to any implementation directory (nodejs, python, php, java, dotnet, go)
3. Set up credentials - Copy .env.sample to .env and add your Global Payments API keys
4. Run the server - Execute ./run.sh to install dependencies and start the server
5. Customize - Modify the code for your specific payment use case

Use Cases You Can Build

This template can be adapted for various payment scenarios:

• Basic Charges - Simple one-time payments
• Authorization/Capture - Two-step payment processing
• Subscriptions - Recurring payment processing
• Refunds - Payment reversal functionality
• Multi-step Checkouts - Complex payment flows
• Payment Methods - Credit cards, ACH, alternative payments

Prerequisites

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

Customization Guide

Adding New Endpoints

Each implementation includes commented examples for common payment operations:

// Authorization only
app.post('/authorize', ...)

// Capture authorized payment  
app.post('/capture', ...)

// Process refund
app.post('/refund', ...)

// Get transaction details
app.get('/transaction/:id', ...)

Modifying Payment Logic

1. Update the /process-payment endpoint for your specific flow
2. Add validation for your required fields
3. Customize error handling and responses
4. Add logging and monitoring as needed

Production Considerations

Enhance the template for production use with:

• Input validation and sanitization
• Comprehensive error handling and logging
• Security headers and rate limiting
• PCI compliance measures
• Monitoring and alerting