Difference between revisions of "Payment Processing Developer Guide"

From Cloud9 Payment Processing Gateway Documentation
Jump to: navigation, search
(Message Format)
(Understanding AVS)
 
(71 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{Template:C9Header|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=
 
=Environment & Client Options=
 
Being a cloud based system, Cloud9 has few restrictions on the integration options.
 
Being a cloud based system, Cloud9 has few restrictions on the integration options.
 
The following are some of the possibilities:
 
The following are some of the possibilities:
 
* Windows
 
* Windows
 +
* Web Browser
 
* Unix/Linux
 
* Unix/Linux
 
* Android
 
* Android
* iPhone
+
* iOS
 
* OS X
 
* OS X
 
* Custom
 
* Custom
Line 20: Line 19:
  
 
==Payment Device Controller (PDC)==
 
==Payment Device Controller (PDC)==
Optional Payment Device Controller (PDC) hides the complexity of low level communications with the payment terminals and adds the Store and Forward functionality, if desired.
+
{{Template:PDC}}
Variations of Payment Device Controller are Payment Mobile Controller (PMC) and Payment Web Controller (PWC) to deal with mobile and web based payment processing functionality respectively.
 
  
 
=System & Process Diagrams=
 
=System & Process Diagrams=
Line 32: Line 30:
 
|
 
|
 
|}
 
|}
 
==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==
 
==Cloud9 Process Diagram==
Line 51: Line 39:
 
|}
 
|}
  
=Protocols=
+
=Understanding AVS=
 
+
If you need to enforce AVS (Address Verification), you can set '''IgnoreAVSresult''' API option to '''N''' (NO).
 
+
If you do so, your software must use post processing to determine the reason for decline and proceed accordingly (not all decline reasons are critical in all conditions).
=Message Format=
+
<br>We have an extensive list of AVS match options.   
The following is a sample XML message format.  While, there are numerous wrappers available for C/C++/C#/Java/HTML programmers, the following will give a general idea of the simplicity of the interface:
+
<br> See this link for: [https://developer.acquired.com/references/issuercodes#:~:text=Issuer%20Response%20Codes.%20Overview.%20We%20will].
<code>  
+
<br>'''The Flow'''
<Request>
+
# AVS pass - ok?
  <Type>Purchase</Type>
+
# IF AVS NOT pass - check the AVS Response Code to decide if to proceed.
  <TotalAmount>10.00</TotalAmount>
+
<br>
  </Request>
+
'''​Please only check the first 5 digits of zip codes'''
<Response>
 
  <Result>Queued</Result>
 
  <TrxToken>1234ABCD</TrxToken>
 
</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></code>
 
  
=Integration Options=
+
=Integration Options and Working Samples=
 
Please choose the integration scenario below, to dive into more detail:
 
Please choose the integration scenario below, to dive into more detail:
My client is a:
+
<br>
==Simple Web Page==
+
{{Template:samples}}
This section is under construction. Please contact us directly @ 561-392-9606 x 701 for information on limited Cloud9 release.
 
 
 
==Point Of Sale==
 
In this section we will discuss the integration options for developers of Point Of Sale (POS) systems.
 
<br>'''There are two main options:'''
 
#&rarr;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]]
 
 
 
==Android==
 
This section is under construction. Please contact us directly @ 561-392-9606 x 701 for information on limited Cloud9 release.
 
 
 
==iPhone==
 
This section is under construction. Please contact us directly @ 561-392-9606 x 701 for information on limited Cloud9 release.
 
  
...
+
=Documentation=
<br>
+
[[Payment Processing API Documentation]]
  
 
{{Template:C9Footer|Integration}}
 
{{Template:C9Footer|Integration}}

Latest revision as of 07:26, 13 September 2024




Cloud9 Payment Gateway Documentation. This site can also be reached at http://docs.cloud9paymentgateway.com

Environment & Client Options

Being a cloud based system, Cloud9 has few restrictions on the integration options. The following are some of the possibilities:

  • Windows
  • Web Browser
  • Unix/Linux
  • Android
  • iOS
  • 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


Main Cloud9 Payment Processing Gateway Integration Diagram
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)

Cloud9 PWC Direct Integration Diagram
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

Cloud9DiagramPOSDetail.jpg

Cloud9 Process Diagram

Cloud9ProcessDiagram.jpg

Understanding AVS

If you need to enforce AVS (Address Verification), you can set IgnoreAVSresult API option to N (NO). If you do so, your software must use post processing to determine the reason for decline and proceed accordingly (not all decline reasons are critical in all conditions).
We have an extensive list of AVS match options.
See this link for: [1].
The Flow

  1. AVS pass - ok?
  2. IF AVS NOT pass - check the AVS Response Code to decide if to proceed.


​Please only check the first 5 digits of zip codes

Integration Options and Working Samples

Please choose the integration scenario below, to dive into more detail:

Web Browser Samples

Web Browser Integration Samples

RESTFul JSON/SOAP

JSON API Documentation

MS Windows Samples

Windows Integration Samples

iOS Integration Samples

iOS Integration Samples

Android Integration Samples

Android Integration Samples

Documentation

Payment Processing API Documentation





From the makers of Cloud9 Payment Processing Gateway and Creditline Credit Card Processing Software