TransFirst Transaction Express Gateway Guide

close

Services and Compatibility

Payment Gateway Company Name:
TransFirst Transaction Express
Services that work with Spreedly:
  • TransFirst Transaction Express
Supported operations:
Purchase, Authorize, Capture, Refund, Void, Verify, Store
Supported payment types:
Credit Card, Bank Account
Regions:
North America
API endpoint URL:
https://ws.transactionexpress.com/portal/merchantframework/MerchantWebServices-v1?wsdl

Authentication and Security

Specific names for credentials:
Gateway, Reg Key

Onboarding Merchants in:

To add a TransFirst Transaction Express gateway:


curl https://core.spreedly.com/v1/gateways.xml \
  -u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
  -H 'Content-Type: application/xml' \
  -d '<gateway>
        <gateway_type>trans_first_transaction_express</gateway_type>
        <gateway_id>Your Gateway ID</gateway_id>
        <reg_key>Your RegKey</reg_key>
      </gateway>'


<gateway>
  <token>RAi3Gnyqd4vg8fvtTapmcHaVdKn</token>
  <gateway_type>trans_first_transaction_express</gateway_type>
  <name>TransFirst Transaction Express</name>
  <description nil="true"/>
  <characteristics>
    <supports_purchase type="boolean">true</supports_purchase>
    <supports_authorize type="boolean">true</supports_authorize>
    <supports_capture type="boolean">true</supports_capture>
    <supports_credit type="boolean">true</supports_credit>
    <supports_general_credit type="boolean">false</supports_general_credit>
    <supports_void type="boolean">true</supports_void>
    <supports_verify type="boolean">true</supports_verify>
    <supports_reference_purchase type="boolean">false</supports_reference_purchase>
    <supports_purchase_via_preauthorization type="boolean">false</supports_purchase_via_preauthorization>
    <supports_offsite_purchase type="boolean">false</supports_offsite_purchase>
    <supports_offsite_authorize type="boolean">false</supports_offsite_authorize>
    <supports_3dsecure_purchase type="boolean">false</supports_3dsecure_purchase>
    <supports_3dsecure_authorize type="boolean">false</supports_3dsecure_authorize>
    <supports_store type="boolean">true</supports_store>
    <supports_remove type="boolean">false</supports_remove>
    <supports_fraud_review type="boolean">false</supports_fraud_review>
    <supports_disburse type="boolean">false</supports_disburse>
  </characteristics>
  <credentials>
  </credentials>
  <gateway_specific_fields>
  </gateway_specific_fields>
  <payment_methods>
    <payment_method>credit_card</payment_method>
    <payment_method>bank_account</payment_method>
    <payment_method>third_party_token</payment_method>
  </payment_methods>
  <state>retained</state>
  <redacted type="boolean">false</redacted>
  <created_at type="dateTime">2018-06-19T17:07:53Z</created_at>
  <updated_at type="dateTime">2018-06-19T17:07:53Z</updated_at>
</gateway>



env = Spreedly::Environment.new('C7cRfNJGODKh4Iu5Ox3PToKjniY', '4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ', base_url: 'https://core.spreedly.com')
env.add_gateway(:trans_first_transaction_express, gateway_id: "Your Gateway ID", reg_key: "Your RegKey")



#<Spreedly::Gateway:0x007fe33291c2e8
@token="YIKL6yXkII3jFkUx2cQ0b6Bs62q",
@created_at="2017-07-27T17:51:11Z",
@updated_at="2017-07-27T17:51:11Z",
@gateway_type="trans_first_transaction_express",
@state="retained",
@name="TransFirst Transaction Express",
@credentials={}>

Gateway specific response fields

An approval response from Tranaction Express can be an automatic partial capture. If this is the case then the rsp_code field will be “10” and the amt field will contain the amount successfully captured. You must then have your customer provide another payment method for the remaining balance.

You can find this information in gateway_specific_response_fields. For example, a transaction could have something like this:

<transaction>
  <token>LgpTNGjsWQs9DwdxcbreUVz0R8p</token>
  <transaction_type>Purchase</transaction_type>
  <gateway_specific_response_fields>
     <trans_first_transaction_express>
       <rsp_code>10</rsp_code>
       <amt>735</amt>
     </trans_first_transaction_express>
  </gateway_specific_response_fields>
</transaction>