Transaction Provider

  File: ~/APP_DATA/transactionProvider.xml
 

The transaction provider contains parameters for the credit card processor. It contains general attributes for sending and receiving transactions from the credit card gateway. There is an attribute called isActive which determines which provider is currently active. Only one provider of a particular type can be active at one time.

Send Parameters

These parameters are used to send transactions to the credit card provider.
Note: The values of all the fields are the field name of the service provider, they are not the real values

  • oc_merchant - The name name of the merchant. This is provided by the service provider
  • oc_pin - The pin or password of the merchant. This is provided by the service provider
  • oc_orderId - The unique identifier for each order. This is usually generated by the merchant while placing the order.
  • oc_emailAddress - The email adddress of the customer who places the order
  • oc_returnUrl - The url which gets called by the service provider after the order is processed
  • oc_nameOnCard - The customer name who placed the order
  • oc_cardName - Type of the card
  • oc_cardNumber - The complete card numbercredit card without any dash or spaces
  • oc_cardNumber1 - The first four digits of the credit card
  • oc_cardNumber2 - the second four digits of the credit card
  • oc_cardNumber3 - The third four digits of the credit card
  • oc_cardNumber4 - The last four digits of the credit card
  • oc_expirationMonth - The two digit expiration month
  • oc_expirationYear - The year when the credit card expired
  • oc_cardStreet1 - The street number for the credit card holder
  • oc_cardStreet2 - The second line of the street number for the credit card holder
  • oc_cardCity - The city for the credit card holder
  • oc_cardState - The state for the credit card holder
  • oc_cardZip - The Zip Code for the credit card holder
  • oc_cardCountry - The country of the credit card holder
  • oc_phoneNumber - The phone number of the credit card holder
  • oc_amount - The total amount of the transaction

Receive Parameters

These parameters are used to receive transactions result from the credit card provider.

  • Status - The status of the return value

Example

This example shows the entry for echo credit card processing.

<provider category="InternalProcessing" name="echo-inc" url="https://wwws.echo-inc.com/scripts/INR200.EXE" isactive="Y">
<send>
<outfield name="oc_merchant" field="merchant_echo_id" value="123456789" />
<outfield name="oc_pin" field="merchant_pin" value="1111111" />
<outfield name="oc_orderId" field="order_number" />
<outfield name="oc_emailAddress" field="merchant_email" />
<outfield name="oc_nameOnCard" field="billing_company_name" />
<outfield name="oc_cardNumber" field="cc_number" />
<outfield name="oc_expirationMonth" field="ccexp_month" />
<outfield name="oc_expirationYear" field="ccexp_year" />
<outfield name="oc_cardStreet1" field="billing_address1" />
<outfield name="oc_cardStreet2" field="billing_address2" />
<outfield name="oc_cardCity" field="billing_city" />
<outfield name="oc_cardState" field="billing_state" />
<outfield name="oc_cardZip" field="billing_zip" />
<outfield name="oc_cardCountry" field="billing_country" />
<outfield name="oc_phoneNumber" field="billing_phone" />
<outfield name="oc_amount" field="grand_total" />
<outfield name="ocfield1" field="transaction_type" value="AS" />
<outfield name="ocfield2" field="order_type" value="S" />
<outfield name="ocfield3" field="counter" value="1" />
<outfield name="ocfield4" field="debug" value="T" />
</send>
<receive>
<infield value="Transaction approved" />
</receive>
</provider>

In the above example the provider category is InternalProcessing, This means that the credit card information is processed internally and will not direct the control to the credit card provider. In the outfield table, the name denotes, OfficeClip given names and the field denotes the field that maps to the provider field. All fields at the bottom like ocfield1, ocfield2 etc. are the fields that are constants and does not change on the input data. Any number of such constant fields can be inserted.

The infield table denotes the response from the credit card processor. The value of the field is checked with the value of the response from the credit card processor. If they match, the transaction is considered to be successful.



 Send us your feedback  Copyright© OfficeClip LLC 2000-2006, All Rights Reserved 

 OfficeClip provides a suite of web-based enterprise software such as Web Contact Manager, Issue and Bug Tracker, Time and Expense Reporting, Free Group Calendar, Free Document Sharing and other applications.