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
- Spreedly 3DS2 Global Supported
- No
- Gateway Specific 3DS1 Supported
- No
- Gateway Specific 3D2 Supported
- No
- 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>