Difference between revisions of "Payment Processing Developer Guide"
(→WebTrans Gateway) |
(→Protocols) |
||
| Line 48: | Line 48: | ||
| | | | ||
|} | |} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=Integration Options= | =Integration Options= | ||
Revision as of 23:14, 18 April 2017
Cloud9 Payment Gateway Documentation. This site can also be reached at http://docs.cloud9paymentgateway.com
Contents
Overview
This section is under construction. Please contact us directly @ 561-392-9606 x 701 for information on limited Cloud9 release.
Environment & Client Options
Being a cloud based system, Cloud9 has few restrictions on the integration options. The following are some of the possibilities:
- Windows
- Unix/Linux
- Android
- iPhone
- OS X
- Custom
Services
Cloud9 Payment Gateway
Cloud9 is essentially a multi-merchant/multi processor switch. Cloud9 reduces the complexity of direct processor and payment terminal programming, certification and compliance by presenting a simple unified interface to the developer with numerous interface options. The core communications are conducted via TLS/SOAP/JSON with wrappers in C/C++/Java, if desired.
Back-Office Reporting Gateway
Cloud9 has a full suite of Back Office Reporting, which can be extended and scripted.
Payment Device Controller (PDC)
Optional Payment Device Controller (PDC) hides the complexity of low level communications with the payment terminals and adds Offline Store & Forward functionality, if desired.
The client (POS/web page/mobile device, etc) can communicate with the PDC, which will in turn control the payment perminal/pin pad and relate the processing instructions to the Cloud9 Payment Gateway.
This is the easiest form of integration and it is recommended.
Note: Variations of Payment Device Controller are Payment Mobile Controller (PMC) and Payment Web Controller (PWC), dealing with mobile and web based payment processing functionality respectively.
→ OPTION1: Local Payment Device Controller with Store and Forward Capability
 |
| The client can communicate with a local Payment Device Controller (PDC) via SOAP, JSON or using the wizard like wrapper, written in C/C++/Java. |
→ OPTION2: No Local Software - Direct Cloud Connection to Cloud9 Payment Web Controller (PWC)
 |
| The client can communicate directly with the cloud Payment Web Controller (PWC) via SOAP, JSON or using the wizard like wrapper, written in C/C++/Java. |
Payment Device Controller Setup
Please, see Cloud9 Payment Device Controller Setup
System & Process Diagrams
POS System Diagram
 |
Payment Device Control Services
|
| The client can communicate directly with the cloud or Payment Device Controller via SOAP, JSON or using the wizard like wrapper, written in C/C++/Java. |
Cloud9 Process Diagram
 |
Integration Options
Please choose the integration scenario below, to dive into more detail:
WebTrans Gateway
The simplest way to use Cloud9.
Please, see Cloud9 WebTrans Guide
Credentials
- URL: https://testlink.c9pg.com:8446/client/client.jsp
- Parameters:
GMID: 1001396259
GTID: GT1001396262
CompanyName: Any name
Key: Any value
Web Based Integration
1) First, visit the following web site to initialize, and select proceed to get over the security message, first (ignore any errors, the test server does not yet have a secure certificate of its own): https://testlink.c9pg.com/
API for Point of Sale
In this section we will discuss the integration options for developers of conventional Point Of Sale (POS) systems.
There are two main options:
- Default: POS uses a payment terminal/pin pad (DEFAULT/Card Present scenario)
- POS does NOT use a payment terminal/pin pad (Card Not Present scenario), or you have already integrated a pin pad into your system
→ Please, see the mini-POS developer package (download, unzip the file and run the executable, the code is in the INC directory)
SOAP/XML
Simple Purchase Payment Request & Response
<Request>
<Type>Purchase</Type>
<TotalAmount>10.00</TotalAmount>
</Request>
<Response>
<Result>Queued</Result>
<TrxToken>1234ABCD</TrxToken>
</Response>
Simple Payment Status Request & Response
<Request>
<Type>Query</Type>
<TrxToken>1234ABCD</TrxToken>
</Request>
<Response>
<Result>Approved</Result>
<ApprovedAmount>10.00</ApprovedAmount>
<AccountBalanceAmount>50.00</AccountBalanceAmount>
<AccountType>Credit</AccountType>
<AccountAssnCode>VS</AccountAssnCode>
<AccountNumber>411111XXXXXX1111</AccountNumber>
<AccountToken>7890XYZ</AccountToken>
</Response>
Documentation
Payment Processing API Documentation
From the makers of Cloud9 Payment Processing Gateway and Creditline Credit Card Processing Software
