Revision as of 21:07, 14 May 2019

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

Step One

Please, review the Developer Guide to determine the best integration approach, before diving into the API Documentation below.

API DOCUMENTATION

→ Full SOAP/JSON API Documentation

See below for a good intro to the API with some examples.

Sample Working JSON

You can try out the examples below, using a free testing tool, such as Postman

Request

POST to URL: https://link.c9pg.com:11911/restApi

{
"GMID": "1511093260",
"GTID": "GT1521035963",
"GMPW": "GMPW3010024515",
"TransType": "Sale",
"Medium": "Credit",
"AccountNum": "4788250000028291",
"CustomerAddress": "8320",
"CustomerZipCode": "85284",
"CVVNum": "999",
"ExpDate": "1222",
"MainAmt": "100",
"TipAmt": "212",
"IncTaxAmt": "153",
"EntryMode": "Manual",
"NeedSwipeCard": "N" }
}

Response

{"AVSResultCode":"Y","AccountNum":"478825******8291","AuthAmt":"312","AuthCode":"TAS246","AuthDate":"20190514","AuthTime":"164509","Brand":"Visa","CVVResultCode":"M","EntryMode":"Manual","ErrorCode":"000","ErrorText":"EXACT MATCH ","ExpDate":"1222","GMID":"1511093260","GMPW":"GMPW3010024515","GTID":"GT1521035963","GTRC":"02c30bb676f14418876666bda2691be9","Medium":"Credit","MerchantAddr":"265 S Federal Hwy","MerchantCity":"Deerfield Beach","MerchantName":"Main Profit Center","MerchantPhoneNum":"5613929606","MerchantState":"Florida","MerchantZip":"33441","NewRecordCreated":"Y","ProcessorID":"40203","ResponseCode":"00","ResponseText":"EXACT MATCH ","ResultCode":"000","ResultText":"EXACT MATCH ","Status":"success","TipAmt":"212","TransType":"Sale","TransactionIdentifier":"000000000198667","SESSIONID":"Web{15173afe-5013-4df8-b74c-ec450155ba75}_1557866709305"}

Test Cards and Amounts

Aside from the example above, only specific account numbers, AVS, CVV and amounts will result in approvals
Please, see TSYS Test Account

Elements

The library has two basic elements:

Connection

Client can either connect directly to
a)Cloud9 Server Payment Web Controller (PWC) - this is a good option is local hardware payment terminals are not used
b)Local Payment Device Controller (PDC), which controls the payment terminal.

Name/Value Pair

Connection Types

1. Payment Device Controller (PDC) Connection:Connects to the local device driver - wss://localhost:5556/
   Advantage: Offline Store & Forward Capability
   Disadvantage: Needs local software install
   
   
2. Web Based Payment Device Controller (PWC):Connects directly to the Cloud9 server - https://testlink.c9pg.com:5558/hj
   Advantage: No local software required, unlimited cross platform capability
   Disadvantage: No Offline Store & Forward Capability
   
   
   

Basic Transaction

{ // REQUEST

 "GMID":"10XXXXXX50",  // Gateway Merchant ID
 "GTID":"GTXXXXXXX53", // Gateway Terminal ID
 "GMPW":"XXX",         // Gateway Password
 "TransType":"Auth",   // Transaction Type
 "Medium":"Credit",    // Transaction Medium (Credit=Credit Card)
 "MainAmt":"123",      // Amount
 "IncTaxAmt":"56",     // Tax Amount
 "SourceTraceNum":"123456"  // Trace Number

}

{ // RESPONSE

 "Status": "success",  // Response Status
 "ResponseCode": "00", // Response Code
 "AuthCode": "12345A"  // Authorization Approval Code

}

Core Key Names / Commands

Core Values

TransType - Transaction Type Command

Medium - Processing Medium Command

Boolean Values

Live Sample Companion

→ NOTE: It is highly recommended that you use the live Integration Samples, which has real time source code windows to help you understand the API.
You can see the JSON Payload at the bottom of the page, for reference.

API Sample Screenshot

Source C Documentation

You might find Payment Gateway C-languages Documentation useful, if you would like to explore the source for JSON interface (see PgcKey.h file for definitions)

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