nodejs

Global Payments Node.js Integration

A comprehensive Node.js implementation for Global Payments payment processing and transaction reporting using Express.js and the Global Payments Node.js SDK.

Requirements

• Node.js 18+
• npm
• Global Payments Portico credentials (PUBLIC_API_KEY, SECRET_API_KEY)

Quick Start

1. Configure Credentials

Copy .env.sample to .env and add your credentials:

PUBLIC_API_KEY=pkapi_cert_your_key_here
SECRET_API_KEY=skapi_cert_your_key_here

2. Install Dependencies

npm install

3. Start the Server

./run.sh

Or manually:

npm start

The application will start on http://localhost:8000

4. Verify Setup

Open your browser to:

• Web Interface: http://localhost:8000/index.html
• Get Public Key: http://localhost:8000/config
• Reporting Config: http://localhost:8000/api/reports?action=config

Features

✅ Payment Processing

• Process card payments with hosted fields tokenization
• Support for billing address verification (AVS)
• Real-time payment processing with Global Payments Portico API

✅ Transaction Reporting

• Search and filter transactions
• Export data (JSON, CSV, XML)
• Generate settlement, dispute, and deposit reports
• Transaction analytics and summaries

API Endpoints

Payment Processing

Get Configuration

curl http://localhost:8000/config

Process Payment

curl -X POST http://localhost:8000/process-payment \
  -d "payment_token=YOUR_TOKEN" \
  -d "billing_zip=12345" \
  -d "amount=25.00"

Transaction Reporting

See REPORTING_README.md for complete reporting API documentation.

Quick Example - Search Transactions

curl "http://localhost:8000/api/reports?action=search&start_date=2025-09-01&page_size=10"

Project Structure

nodejs/
├── server.js                     # Main Express application
├── reports.js                    # Reporting API endpoints
├── reporting-service.js          # Reporting service logic
├── index.html                    # Payment form UI
├── package.json                  # Node.js dependencies
├── .env                          # Your credentials (not in git)
├── .env.sample                   # Credential template
├── README.md                     # This file
└── REPORTING_README.md           # Reporting API documentation

Usage

Processing a Payment

1. Open http://localhost:8000/index.html in your browser
2. Use test card: 4012002000060016
3. Enter any future expiration date
4. Enter CVV: 123
5. Enter billing ZIP code
6. Click "Pay $10.00"

Searching Transactions

After processing payments, search for them:

curl "http://localhost:8000/api/reports?action=search&page_size=20"

Exporting Data

Export transactions to CSV:

curl "http://localhost:8000/api/reports?action=export&format=csv&start_date=2025-09-01" -o transactions.csv

Testing

Test Card Numbers

Card Type	Number	CVV	Expiry
Visa	4012002000060016	123	Any future date
Mastercard	5473500000000014	123	Any future date
Amex	372700699251018	1234	Any future date

Testing Workflow

1. Process a payment using the web interface
2. Verify transaction appears in reporting:

   curl "http://localhost:8000/api/reports?action=search"

3. Get transaction details:

   curl "http://localhost:8000/api/reports?action=detail&transaction_id=TRN_xxx"

Environment Variables

Variable	Required	Description
PUBLIC_API_KEY	Yes	Portico public key for payment processing
SECRET_API_KEY	Yes	Portico secret key for payment processing
PORT	No	Server port (default: 8000)

Troubleshooting

Port already in use?

# Use a different port:
PORT=8080 npm start

Missing credentials error?

• Ensure .env file exists in the nodejs/ directory
• Verify all required credentials are set
• Check for trailing spaces in credential values

Payment processing fails?

• Verify PUBLIC_API_KEY and SECRET_API_KEY are correct
• Ensure using test credentials for test environment

npm install fails?

• Ensure Node.js 18+ is installed: node --version
• Remove node_modules and retry: rm -rf node_modules && npm install

Documentation

• Payment Processing: See API Endpoints section above
• Transaction Reporting: See REPORTING_README.md
• Global Payments Docs: https://developer.globalpayments.com

Support

For issues or questions:

• Global Payments Developer Portal: https://developer.globalpayments.com
• SDK Documentation: https://github.com/globalpayments/nodejs-sdk