Payment Processing API Documentation

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

Overview

The following document will give a good idea of how to use our Payment Gateway Client API (PGCApi), which have wrappers for other languages (VB, JS, etc) This is a simpler value pair operation library

Flow

1. Initialize the library
   PgcInit("PgcSample");
2. Connect to the Payment Web Controller (PWC - direct Cloud9 Server connection) or local Payment Device Controller (PDC) Server
   1. Create Connection Handle
      int nConn = PgcNewConn(PGC_SVC_C9PG_PDC, "Name", "Token", PGC_TIMEO_TXN_UI, "PgcSample", ""); //USE PGC_SVC_C9PG_PWE_TEST for PWE
   2. Open the Connection, specified by Connection Handle
      int nErr = PgcConnect(nConn);
3. Create New Session
   int nSess = PgcNewSess(nConn, 1);
4. Set Session Parameters
   1. Set MID/TID/PWD
      PgcSetStr(nSess, 0, PGC_GWKEY_GMID, "1001396250"); // Gateway merchant ID
PgcSetStr(nSess, 0, PGC_GWKEY_GTID, "GT1001396253"); // Gateway terminal ID
PgcSetStr(nSess, 0, PGC_GWKEY_GMPW, "123"); // Gateway merchant password
   2. Set Transaction Type
      PgcSetStr(nSess, 0, PGC_GWKEY_TXNACT, PGC_GWVAL_TXNACT_AUTH); // Transaction action type -> authorization
   3. Set Transaction Medium (e.g. Credit Card)
      PgcSetStr(nSess, 0, PGC_GWKEY_MDM, PGC_GWVAL_MDM_CREDIT); // Payment medium -> credit card
   4. Set Transaction Parameters (e.g. Amount, Tax, Trace#)
      PgcSetAmt(nSess, 0, PGC_GWKEY_MAINAMT, 123); // Main amount -> $1.23
PgcSetAmt(nSess, 0, PGC_GWKEY_INCTAXAMT, 8); // Included tax amount -> $0.08
PgcSetStr(nSess, 0, PGC_GWKEY_SRCTRACENUM, "123456"); // Source trace number; will be returned for matching
5. Send the Request for this Session
   int nErr = PgcRequest(nSess);
6. Get Response and Approval Code for the Session
   PgcGetStr(nSess, 0, PGC_GWKEY_STATUS, sStatus, 256); // Transaction status, indicating if it is successful
...
PgcGetStr(nSess, 0, PGC_GWKEY_RSPCODE, sRspCode, 256); // Response code returned from the host
...
PgcGetStr(nSess, 0, PGC_GWKEY_RSPTEXT, sRspText, 256); // Response text returned from the host
...
PgcGetStr(nSess, 0, PGC_GWKEY_AUTHCODE, sAuthCode, 256); // Auth code
7. Close the Session
   PgcFreeSess(nSess);
8. Disconnect from Server<brPgcDisconnect(nConn); // Disconnecting from the controller; will be called automatically upon closing
PgcFreeConn(nConn); // Closing connection to the controller; called once per connection
9. Un-Initialize
   PgcUninit("PgcSample"); // Uninitializing library; called once per application upon exit

→ Online Documentation: Payment Gateway Client Library ver 17.08.14 documentation

Samples

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

---

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