Section 1. Remote Authorization

Defines the Remote Authorization endpoint, request format requirements, and data handling rules for API transactions.

Overview

Remote Authorization allows credit card transactions to be processed by submitting an HTTP POST request containing the required transaction variables. The system returns a URL-encoded response string that can be parsed programmatically.

This method is also used by available API/COM libraries and serves as the reference implementation for request and response name/value pairs.

Payment Endpoint

https://pay1.plugnpay.com/payment/pnpremote.cgi

Request Requirements

All requests submitted to the Remote Authorization endpoint must adhere to the following rules:

  • Data must be submitted using HTTP POST.
  • All variable names and values must be properly URL encoded prior to transmission.
  • All input values must be validated and correctly formatted before submission.

Implementation Notes

  1. All data values must be URL encoded or escaped before being sent to the endpoint.

  2. All submitted data must be properly filtered and formatted to ensure successful processing and to prevent request errors.

Notes

The Remote Authorization interface is designed to provide a consistent integration layer across multiple client libraries, enabling standardized transaction submission and response handling.

⚠️ Important: Include only the fields you plan to define; omit any unused fields.


Account Identifiers and Flags

Defines Remote API account authentication, transaction behavior, and processing control parameters.

ACH/eCheck

Defines ACH and eCheck transaction parameters for Remote API payment processing.

Amount

Defines transaction amount related parameters for Remote API processing.

Ancillary Data

Defines order IDs, invoice numbers, and custom merchant-defined fields.

Billing Address

Defines customer billing address and contact information fields for Remote API transaction processing.

Credit Card

Defines credit card, retail swipe, encrypted track data, and processor-specific transaction fields for Remote API processing.

Itemization and Definition

Defines transaction amount, itemization, fraud screening, reporting, and custom field parameters for Remote API processing.

Level II Purchase Cards

Defines required fields for Level II purchase card processing through the Remote API.

Level III Purchase Cards

Defines requierd fields and transaction handling behavior for Level III purchase card processing through the Remote API.

Multi-Currency Pricing

Defines Multi-Currency Pricing (MCP) behavior, supported currencies, and additional response fields for currency conversion processing.

Petroleum Cards

Define Petroleum Fleet Card transactions, including required parameters and product codes.

Shipping Address

Defines shipping address and delivery information fields used for Remote API transaction processing and confirmation outputs.

Visa 3D Secure

Defines Visa 3D Secure authentication flow, required request parameters, and post-authentication handling for Remote API transactions.

Visa 3D Secure - With Cardinal Commerce MPI

Defines required authentication fields for Visa 3D Secure transactions using Cardinal Commerce MPI.

Transaction Response

Defines response fields and transaction handling behavior for authorization processing through the Remote API.