View source for Payment Processing Developer Guide

{{Template:C9Header|Developer Guide}}
=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)==
{{Template:PDC}}

=System & Process Diagrams=

==POS System Diagram==
{| style=" border: 1px dashed red; width="400px" 
|- style="vertical-align: top;"
|[[File:Cloud9DiagramPOSDetail.jpg|none|600px|]]
|-
|
|}

==Payment Device Control Services==
<br>
{| style=" border: 1px dashed red; width="400px" 
|- style="vertical-align: top;"
|[[File:PDCClientCloud.jpg|none|600px|Main Cloud9 Payment Processing Gateway Integration Diagram]]
|-
|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==
{| style=" border: 1px dashed red; width="400px" 
|- style="vertical-align: top;"
|[[File:Cloud9ProcessDiagram.jpg|none|600px|]]
|-
|
|}

=Integration Options=
Please choose the integration scenario below, to dive into more detail:
==WebTrans Gateway==
The simplest way to use Cloud9. Point Of Sale uses Cloud9s call-back web page to process payments<br>
For more info see [[Cloud9 WebTrans Payment Processing Call-Back Web Page]]
[[image:webtrans.jpg|thumb|WebTrans Screenshot]]<br>

==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:5551/hj https://testlink.c9pg.com/] 

*[http://samples.c9pg.com/html/c9pg_client_html_test.htm Running HTML Client with active source code display]
*[http://samples.c9pg.com/html/ Source Code]

==API for Point of Sale==
In this section we will discuss the integration options for developers of conventional Point Of Sale (POS) systems.
<br>'''There are two main options:'''
# Default: POS uses a payment terminal/pin pad ('''DEFAULT'''/[[Glossary:Card Present|Card Present]] scenario)<br><!--Proceed to the [[Cloud9 Payment Device Controller API Guide]]-->
# POS does '''NOT''' use a payment terminal/pin pad ([[Glossary:Card Not Present|Card Not Present]] scenario), or you have already integrated a pin pad into your system<br><!--Proceed to the [[Cloud9 Direct API Guide]]-->

&rarr; Please, see the '''[http://cloud9paymentgateway.com/files/API/samples 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===
 <code><Request>
   <Type>Purchase</Type>
   <TotalAmount>10.00</TotalAmount>
 </Request>
 <Response>
   <Result>Queued</Result>
   <TrxToken>1234ABCD</TrxToken>
 </Response></code>

===Simple Payment Status Request & Response===
 <code><Request>
   <Type>Query</Type>
   <TrxToken>1234ABCD</TrxToken>
 </Request>
 <!-- Payment Status Query Response-->
 <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></code>
<br>

=Documentation=
[[Payment Processing API Documentation]]

{{Template:C9Footer|Integration}}