Difference between revisions of "JSON API Documentation"

From Cloud9 Payment Processing Gateway Documentation
Jump to: navigation, search
(Created page with "{{Template:C9Header|JSON API Documentation}} =Step One= Please, review the '''Developer Guide''' to determine the best integration appro...")
 
(Available Commands and Operands)
Line 31: Line 31:
 
}
 
}
  
=Available Commands and Operands=
+
=Core Commands/Key Names=
==Transaction Type==
+
==Core Commands==
 
{| class="wikitable"
 
{| class="wikitable"
!scope="col"|Command
+
!scope="col"|Value
!scope="col"|Action
+
!scope="col"|Explanation
 +
|-
 +
|GMID
 +
|Gateway Merchant ID
 +
|-
 +
|GTID
 +
|Gateway Terminal ID
 +
|-
 +
|GMPW
 +
|Gateway Account Password
 +
|-
 +
|TransType
 +
|Transaction Type
 +
|-
 +
|Medium
 +
|Transaction Medium (e.g. Credit Card/Debit Card/etc)
 +
|-
 +
|MainAmt
 +
|Main Transaction Amount
 +
|-
 +
|IncTaxAmt
 +
|Tax Amount
 +
|-
 +
|SourceTraceNum
 +
|Merchant Transaction Trace Number
 +
|-
 +
|IncTaxAmt
 +
|Tax Amount
 +
|-
 +
|InvoiceNum
 +
|Invoice Number
 +
|-
 +
|OrderNum
 +
|Order Number
 +
|-
 +
|VoucherNum
 +
|Voucher Number
 +
|-
 +
|AdditionalInfo
 +
|Additional Transaction Info
 +
|-
 +
|AccountNum
 +
|Account Number (optional - only needed if PDC is not used to control the payment terminal)
 +
|-
 +
|ExpDate
 +
|Expiration Date (optional - only needed if PDC is not used to control the payment terminal)
 +
|-
 +
|Track1
 +
|Track1 of Card (optional - only needed if PDC is not used to control the payment terminal)
 +
|-
 +
|Track2
 +
|Track2 of Card (optional - only needed if PDC is not used to control the payment terminal)
 +
|-
 +
|PinData
 +
|Pin Data for Debit (optional - only needed if PDC is not used to control the payment terminal)
 +
|-
 +
|CardPresent
 +
|Sets the Card Present Indicator (optional)
 +
|}
 +
 
 +
 
 +
 
 +
==TransType - Transaction Type Command==
 +
{| class="wikitable"
 +
!scope="col"|Value
 +
!scope="col"|Explanation
 
|-
 
|-
 
|Auth
 
|Auth
Line 68: Line 133:
 
|}
 
|}
  
 
+
==Medium - Processing Medium Command==
 +
{| class="wikitable"
 +
!scope="col"|Value
 +
!scope="col"|Explanation
 +
|-
 +
|Credit
 +
|Credit Card
 +
|-
 +
|Debit
 +
|Debit Card
 +
|-
 +
|Gift
 +
|Prepaid
 +
|-
 +
|Prepaid
 +
|Prepaid Card
 +
|-
 +
|EBTCash
 +
|EBT Cash
 +
|-
 +
|EBTFood
 +
|EBT Food
 +
|}
  
 
=Live Sample Companions=
 
=Live Sample Companions=

Revision as of 01:51, 21 August 2017




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.

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

PDC Connection
Connects to the local device driver - wss://localhost:5556/
PWC Connection
Connects directly to the Cloud9 server - https://testlink.c9pg.com:5558/hj

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 Commands/Key Names

Core Commands

Value Explanation
GMID Gateway Merchant ID
GTID Gateway Terminal ID
GMPW Gateway Account Password
TransType Transaction Type
Medium Transaction Medium (e.g. Credit Card/Debit Card/etc)
MainAmt Main Transaction Amount
IncTaxAmt Tax Amount
SourceTraceNum Merchant Transaction Trace Number
IncTaxAmt Tax Amount
InvoiceNum Invoice Number
OrderNum Order Number
VoucherNum Voucher Number
AdditionalInfo Additional Transaction Info
AccountNum Account Number (optional - only needed if PDC is not used to control the payment terminal)
ExpDate Expiration Date (optional - only needed if PDC is not used to control the payment terminal)
Track1 Track1 of Card (optional - only needed if PDC is not used to control the payment terminal)
Track2 Track2 of Card (optional - only needed if PDC is not used to control the payment terminal)
PinData Pin Data for Debit (optional - only needed if PDC is not used to control the payment terminal)
CardPresent Sets the Card Present Indicator (optional)


TransType - Transaction Type Command

Value Explanation
Auth Authorization. Authorization is a non-finalized transaction that is used in a tip environment. Add tip to finalize. Only finalized transactions are batched/settled
Sale Sale. Sale is a finalized transaction that will be included in the next batch/settlement
AddTip Adds Tip to an Auth, finalizing it and getting it ready to be batched/settled
Modify Modifies a transaction, also finalizing it and getting it ready to be batched/settled
Void Voids a transaction
Refund Refunds a transaction
Inquiry Debit, Credit or Gift Card Card Balance Inquiry
Activate Activate a Gift Card
AddValue Add Value to a Gift Card
Deactivate Deactivate a Gift Card

Medium - Processing Medium Command

Value Explanation
Credit Credit Card
Debit Debit Card
Gift Prepaid
Prepaid Prepaid Card
EBTCash EBT Cash
EBTFood EBT Food

Live Sample Companions

NOTE: It is highly recommended that you use the live PDC API Sample or WEB API Sample,
which have real time source code windows to help you understand the API.

Using API Documentation

  • There are two main files of interest:
PgcClient.h
contains functions
PgcKey.h
contains parameter definitions for the key pairs

You can use the File List and File Member functions like so, to get more detail on what is available.
You can also use Search to find a function


Doxygen1.jpg

Doxygen1a.jpg


This is how you can browse the parameter definitions


Doxygen3.jpg

Cloud9 Payment Gateway Documentation

Please, see Payment Gateway Documentation Portal





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