Vantiv eCommerce (formerly Litle) gateway guide
Additional notes |
---|
Spreedly’s integration with the Vantiv eCommerce gateway uses the 9.14 version of their API. |
Please note Vantiv eCommerce (formerly Litle) gateway flags “duplicate transactions” based on order_id . To avoid having legitimate transactions unfulfilled at the gateway, please ensure order_id is unique for supported transactions. |
Adding a Vantiv gateway
Default auth mode
To add a Vantiv eCommerce (formerly Litle) gateway using your own user
, password
, and merchant_id
:
curl https://core.spreedly.com/v1/gateways.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<gateway>
<gateway_type>litle</gateway_type>
<user>user</user>
<password>password</password>
<merchant_id>your merchant id</merchant_id>
</gateway>'
<gateway>
<token>5etkum2SDFfxKVdM3C2dc2gRSx</token>
<gateway_type>litle</gateway_type>
<name>Vantiv eCommerce (formerly Litle)</name>
<description nil="true"/>
<merchant_profile_key nil="true"/>
<sub_merchant_key nil="true"/>
<user>user</user>
<merchant_id>your merchant id</merchant_id>
<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">true</supports_general_credit>
<supports_void type="boolean">true</supports_void>
<supports_adjust type="boolean">false</supports_adjust>
<supports_verify type="boolean">true</supports_verify>
<supports_reference_purchase type="boolean">true</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_offsite_synchronous_purchase type="boolean">false</supports_offsite_synchronous_purchase>
<supports_offsite_synchronous_authorize type="boolean">false</supports_offsite_synchronous_authorize>
<supports_3dsecure_purchase type="boolean">false</supports_3dsecure_purchase>
<supports_3dsecure_authorize type="boolean">false</supports_3dsecure_authorize>
<supports_3dsecure_2_mpi_purchase type="boolean">false</supports_3dsecure_2_mpi_purchase>
<supports_3dsecure_2_mpi_authorize type="boolean">false</supports_3dsecure_2_mpi_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_network_tokenization type="boolean">true</supports_network_tokenization>
<supports_populate_mit_fields type="boolean">false</supports_populate_mit_fields>
<supports_inquire_by_gateway_transaction_id type="boolean">false</supports_inquire_by_gateway_transaction_id>
<supports_inquire_by_order_id type="boolean">false</supports_inquire_by_order_id>
<supports_transaction_retry type="boolean">false</supports_transaction_retry>
<supports_stored_stored_credentials type="boolean">false</supports_stored_stored_credentials>
<supports_stored_credentials type="boolean">true</supports_stored_credentials>
</characteristics>
<credentials>
<credential>
<name>user</name>
<value>user</value>
</credential>
<credential>
<name>merchant_id</name>
<value>your merchant id</value>
</credential>
</credentials>
<gateway_settings>
<url_override nil="true"/>
</gateway_settings>
<gateway_specific_fields>
<gateway_specific_field>descriptor_name</gateway_specific_field>
<gateway_specific_field>descriptor_phone</gateway_specific_field>
<gateway_specific_field>order_source</gateway_specific_field>
<gateway_specific_field>report_group</gateway_specific_field>
<gateway_specific_field>customer_id</gateway_specific_field>
<gateway_specific_field>debt_repayment</gateway_specific_field>
<gateway_specific_field>cavv</gateway_specific_field>
<gateway_specific_field>xid</gateway_specific_field>
<gateway_specific_field>campaign</gateway_specific_field>
<gateway_specific_field>merchant_grouping_id</gateway_specific_field>
<gateway_specific_field>affiliate</gateway_specific_field>
<gateway_specific_field>send_expiration_date_with_token</gateway_specific_field>
<gateway_specific_field>stored_credential_initiator</gateway_specific_field>
<gateway_specific_field>stored_credential_processing_type</gateway_specific_field>
<gateway_specific_field>stored_credential_transaction_id</gateway_specific_field>
<gateway_specific_field>fraud_filter_override</gateway_specific_field>
</gateway_specific_fields>
<payment_methods>
<payment_method>credit_card</payment_method>
<payment_method>third_party_token</payment_method>
<payment_method>apple_pay</payment_method>
<payment_method>google_pay</payment_method>
<payment_method>bank_account</payment_method>
</payment_methods>
<state>retained</state>
<redacted type="boolean">false</redacted>
<sandbox type="boolean">false</sandbox>
<mode>default</mode>
<created_at type="dateTime">2023-06-06T17:09:13Z</created_at>
<updated_at type="dateTime">2023-06-06T17:09:13Z</updated_at>
</gateway>
Merchant ID only mode
Spreedly maintains “Partner-Presenter” credentials with Vantiv eCommerce (formerly Litle), certified for the current version of their API we are integrated with, which is version 9.14.
Spreedly has two sets of these credentials - one for Production and one for the Prelive environment. The correct set is used depending on which environment is selected. Both are certified for API version 9.14.
If you wish to utilize these credentials instead of your own set of user
and password
, you must contact Vantiv and request that your Merchant ID be connected to Spreedly’s Partner Presenter credentials for each of Vantiv’s environments (Production and Prelive) that you wish to be able to transact against. If you are a merchant aggregator handling multiple Vantiv MIDs, each will need to be connected in this way.
Then, when creating a gateway, set mode
to merchant_id_only
, and provide only merchant_id
.
The following example creates a Production gateway in merchant_id_only
mode:
curl https://core.spreedly.com/v1/gateways.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<gateway>
<gateway_type>litle</gateway_type>
<mode>merchant_id_only</mode>
<merchant_id>your merchant id</merchant_id>
</gateway>'
<gateway>
<token>2MPcJqlWKzTgXGazj2d4LbBSjfy</token>
<gateway_type>litle</gateway_type>
<name>Vantiv eCommerce (formerly Litle)</name>
<description nil="true"/>
<merchant_profile_key nil="true"/>
<sub_merchant_key nil="true"/>
<merchant_id>your merchant id</merchant_id>
<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">true</supports_general_credit>
<supports_void type="boolean">true</supports_void>
<supports_adjust type="boolean">false</supports_adjust>
<supports_verify type="boolean">true</supports_verify>
<supports_reference_purchase type="boolean">true</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_offsite_synchronous_purchase type="boolean">false</supports_offsite_synchronous_purchase>
<supports_offsite_synchronous_authorize type="boolean">false</supports_offsite_synchronous_authorize>
<supports_3dsecure_purchase type="boolean">false</supports_3dsecure_purchase>
<supports_3dsecure_authorize type="boolean">false</supports_3dsecure_authorize>
<supports_3dsecure_2_mpi_purchase type="boolean">false</supports_3dsecure_2_mpi_purchase>
<supports_3dsecure_2_mpi_authorize type="boolean">false</supports_3dsecure_2_mpi_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_network_tokenization type="boolean">false</supports_network_tokenization>
<supports_populate_mit_fields type="boolean">false</supports_populate_mit_fields>
<supports_inquire_by_gateway_transaction_id type="boolean">false</supports_inquire_by_gateway_transaction_id>
<supports_inquire_by_order_id type="boolean">false</supports_inquire_by_order_id>
<supports_transaction_retry type="boolean">false</supports_transaction_retry>
<supports_stored_stored_credentials type="boolean">false</supports_stored_stored_credentials>
<supports_stored_credentials type="boolean">true</supports_stored_credentials>
</characteristics>
<credentials>
<credential>
<name>merchant_id</name>
<value>your merchant id</value>
</credential>
</credentials>
<gateway_settings>
<url_override nil="true"/>
</gateway_settings>
<gateway_specific_fields>
<gateway_specific_field>descriptor_name</gateway_specific_field>
<gateway_specific_field>descriptor_phone</gateway_specific_field>
<gateway_specific_field>order_source</gateway_specific_field>
<gateway_specific_field>report_group</gateway_specific_field>
<gateway_specific_field>customer_id</gateway_specific_field>
<gateway_specific_field>debt_repayment</gateway_specific_field>
<gateway_specific_field>cavv</gateway_specific_field>
<gateway_specific_field>xid</gateway_specific_field>
<gateway_specific_field>campaign</gateway_specific_field>
<gateway_specific_field>merchant_grouping_id</gateway_specific_field>
<gateway_specific_field>affiliate</gateway_specific_field>
<gateway_specific_field>send_expiration_date_with_token</gateway_specific_field>
<gateway_specific_field>stored_credential_initiator</gateway_specific_field>
<gateway_specific_field>stored_credential_processing_type</gateway_specific_field>
<gateway_specific_field>stored_credential_transaction_id</gateway_specific_field>
<gateway_specific_field>fraud_filter_override</gateway_specific_field>
</gateway_specific_fields>
<payment_methods>
<payment_method>credit_card</payment_method>
<payment_method>third_party_token</payment_method>
<payment_method>apple_pay</payment_method>
<payment_method>android_pay</payment_method>
<payment_method>google_pay</payment_method>
<payment_method>bank_account</payment_method>
</payment_methods>
<state>retained</state>
<redacted type="boolean">false</redacted>
<sandbox type="boolean">false</sandbox>
<mode>merchant_id_only</mode>
<created_at type="dateTime">2023-05-02T15:28:39Z</created_at>
<updated_at type="dateTime">2023-05-02T15:28:39Z</updated_at>
</gateway>
Vantiv environments and the URL override setting
The Vantiv eCommerce API has three environments:
- Sandbox: A very basic, stateless testing environment
- Prelive: A testing environment used for certification which will behave as expected by Vantiv’s test cases
- Production: The live environment
Testing against Vantiv’s Prelive environment requires passing the url_override
setting as prelive
when creating a Spreedly gateway. Testing in their Sandbox requires passing only the sandbox
setting to true
. Note that if url_override
is provided, the sandbox
flag is ignored. Sending neither of these flags will create a Production gateway.
It is recommended that you create separate gateways for each environment you wish to transact in, rather than changing these values via an update gateway call against an existing gateway.
For clarity, this table lays out the Vantiv Environments and actual URL endpoints hit for certain gateway setting combinations:
Vantiv environment | Endpoint URL | sandbox setting | URL_override setting |
---|---|---|---|
Sandbox | https://www.testvantivcnp.com/sandbox/ | true | Empty or not present |
Prelive | https://payments.vantivprelive.com/vap/ | Any (not evaluated) | prelive |
Production | https://payments.vantivcnp.com/vap/ | false , empty, or not present | Empty or not present |
The gateway created with the example call below will hit the Prelive environment in merchant_id_only
mode (utilizing Spreedly’s Partner-Presenter Credentials):
curl https://core.spreedly.com/v1/gateways.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<gateway>
<gateway_type>litle</gateway_type>
<url_override>prelive</url_override>
<mode>merchant_id_only</mode>
<merchant_id>merchant_id</merchant_id>
</gateway>'
Stored credentials regulations
For Litle there are two options for sending stored credential fields. You can either use Spreedly’s native support which is less hands on, or use gateway specific fields. Using gateway specific fields will give you more fine grain control over what is sent, however you will need to store additional data from the gateway that is returned in a gateway specific response field.
The three gateway specific fields are stored_credential_initiator
, stored_credential_transaction_id
, and stored_credential_processing_type
. Note that the stored_credential_transaction_id
is a Gateway Specific Response Field returned from the first use of a stored payment method. Additionally, it is different from a transaction’s gateway_transaction_id
and you should track and provide with any subsequent transactions using that retained card.
Gateway specific fields
When interacting with a Vantiv eCommerce (formerly Litle) gateway to run transactions, there are some gateway specific fields you can specify.
Dynamic descriptors, descriptor_name
and descriptor_phone
, can be used by the merchant to define what will appear on the customer’s credit card statement for the purchase.
You can use report_group
to separate your transactions into different categories.
order_source
, customer_id
, debt_repayment
, campaign
, affiliate
, and merchant_grouping_id
may also be sent.
3DSecure data can be passed using cavv
and xid
fields. Please note that in order for 3DSecure transactions to succeed with Vantiv, you must also send the order_source
field with a value of either 3dsAuthenticated
or 3dsAttempted
.
Vantiv eCommerce may require an expiration date when transacting against debit cards vaulted on their platform. A transaction executed with the send_expiration_date_with_token
field set to any value will send the expiration date for the corresponding card if the payment method used is a third party token (see Third-party vaulting).
fraud_filter_override
may be sent with a boolean value. A setting of true
will override (disable) all fraud filters for the submitted transaction.
level_2_data
and level_3_data
enhanced data fields may be passed to achieve Level 2 or Level 3 Interchange rates for Visa and Mastercard. Also note that the line_items
subfield accepts an array of objects. Please visit the Worldpay documentation for more details. An example of these fields for either Visa or Mastercard can be found below:
Visa enhanced level 2 and 3 data field examples:
curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/purchase.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<transaction>
<payment_method_token>56wyNnSmuA6CWYP7w0MiYCVIbW6</payment_method_token>
<amount>100</amount>
<currency_code>USD</currency_code>
<gateway_specific_fields>
<litle>
<level_2_data>
<sales_tax>200</sales_tax>
</level_2_data>
</litle>
</gateway_specific_fields>
</transaction>'
curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/purchase.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<transaction>
<payment_method_token>56wyNnSmuA6CWYP7w0MiYCVIbW6</payment_method_token>
<amount>100</amount>
<currency_code>USD</currency_code>
<gateway_specific_fields>
<litle>
<level_3_data>
<discount_amount>50</discount_amount>
<shipping_amount>50</shipping_amount>
<duty_amount>20</duty_amount>
<tax_included_in_total>true</tax_included_in_total>
<tax_amount>100</tax_amount>
<tax_rate>0.05</tax_rate>
<tax_type_identifier>01</tax_type_identifier>
<card_acceptor_tax_id>361531321</card_acceptor_tax_id>
<line_items type="array">
<line_item>
<item_sequence_number>1</item_sequence_number>
<commodity_code>12345</commodity_code>
<item_description>random-object</item_description>
<product_code>TB123</product_code>
<quantity>2</quantity>
<unit_of_measure>EACH</unit_of_measure>
<unit_cost>25</unit_cost>
<discount_per_line_item>5</discount_per_line_item>
<line_item_total>300</line_item_total>
<tax_included_in_total>true</tax_included_in_total>
<tax_amount>100</tax_amount>
<tax_rate>0.05</tax_rate>
<tax_type_identifier>01</tax_type_identifier>
<card_acceptor_tax_id>361531321</card_acceptor_tax_id>
</line_item>
</line_items>
</level_3_data>
</litle>
</gateway_specific_fields>
</transaction>'
Mastercard enhanced level 2 and 3 data field examples:
curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/purchase.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<transaction>
<payment_method_token>56wyNnSmuA6CWYP7w0MiYCVIbW6</payment_method_token>
<amount>100</amount>
<currency_code>USD</currency_code>
<gateway_specific_fields>
<litle>
<level_2_data>
<total_tax_amount>200</total_tax_amount>
<customer_code>PO12345</customer_code>
<card_acceptor_tax_id>011234567</card_acceptor_tax_id>
<tax_included_in_total>true</tax_included_in_total>
<tax_amount>50</tax_amount>
</level_2_data>
</litle>
</gateway_specific_fields>
</transaction>'
curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/purchase.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<transaction>
<payment_method_token>56wyNnSmuA6CWYP7w0MiYCVIbW6</payment_method_token>
<amount>100</amount>
<currency_code>USD</currency_code>
<gateway_specific_fields>
<litle>
<level_3_data>
<total_tax_amount>200</total_tax_amount>
<customer_code>PO12345</customer_code>
<card_acceptor_tax_id>011234567</card_acceptor_tax_id>
<tax_included_in_total>true</tax_included_in_total>
<tax_amount>50</tax_amount>
<line_items type="array">
<line_item>
<item_description>random-object</item_description>
<product_code>TB123</product_code>
<quantity>2</quantity>
<unit_of_measure>EACH</unit_of_measure>
<line_item_total>300</line_item_total>
</line_item>
</line_items>
</level_3_data>
</litle>
</gateway_specific_fields>
</transaction>'
You can pass these gateway specific fields like so:
curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/purchase.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<transaction>
<payment_method_token>56wyNnSmuA6CWYP7w0MiYCVIbW6</payment_method_token>
<amount>100</amount>
<currency_code>USD</currency_code>
<gateway_specific_fields>
<litle>
<descriptor_name>companyName</descriptor_name>
<descriptor_phone>1331131131</descriptor_phone>
<customer_id>88</customer_id>
<debt_repayment>true</debt_repayment>
<report_group>Domestic Business</report_group>
<campaign>Campaign Name</campaign>
<affiliate>Affiliate Name</affiliate>
<merchant_grouping_id>Merchant Group</merchant_grouping_id>
<order_source>recurring</order_source>
<cavv>CAVV</cavv>
<xid>XID</xid>
<send_expiration_date_with_token>true</send_expiration_date_with_token>
<stored_credential_initiator>merchant</stored_credential_initiator>
<stored_credential_processing_type>unscheduled</stored_credential_processing_type>
<stored_credential_transaction_id>160280498621098</stored_credential_transaction_id>
<fraud_filter_override>true</fraud_filter_override>
</litle>
</gateway_specific_fields>
</transaction>'
<transaction>
<on_test_gateway type="boolean">true</on_test_gateway>
<created_at type="dateTime">2022-09-02T19:53:25Z</created_at>
<updated_at type="dateTime">2022-09-02T19:53:25Z</updated_at>
<succeeded type="boolean">true</succeeded>
<state>succeeded</state>
<token>5ij9n4VVkirUUuSB2DhF19HcwDf</token>
<transaction_type>Purchase</transaction_type>
<order_id nil="true"/>
<ip nil="true"/>
<description nil="true"/>
<email nil="true"/>
<merchant_name_descriptor nil="true"/>
<merchant_location_descriptor nil="true"/>
<merchant_profile_key nil="true"/>
<gateway_specific_fields>
<litle>
<descriptor_name>companyName</descriptor_name>
<descriptor_phone>1331131131</descriptor_phone>
<customer_id>88</customer_id>
<debt_repayment>true</debt_repayment>
<report_group>Domestic Business</report_group>
<campaign>Campaign Name</campaign>
<affiliate>Affiliate Name</affiliate>
<merchant_grouping_id>Merchant Group</merchant_grouping_id>
<order_source>recurring</order_source>
<cavv>CAVV</cavv>
<xid>XID</xid>
<send_expiration_date_with_token>true</send_expiration_date_with_token>
<stored_credential_initiator>merchant</stored_credential_initiator>
<stored_credential_processing_type>unscheduled</stored_credential_processing_type>
<stored_credential_transaction_id>160280498621098</stored_credential_transaction_id>
<fraud_filter_override>true</fraud_filter_override>
</litle>
</gateway_specific_fields>
<gateway_specific_response_fields>
</gateway_specific_response_fields>
<gateway_transaction_id>47</gateway_transaction_id>
<sub_merchant_key nil="true"/>
<gateway_latency_ms type="integer">1</gateway_latency_ms>
<stored_credential_initiator nil="true"/>
<stored_credential_reason_type nil="true"/>
<populate_mit_fields type="boolean">false</populate_mit_fields>
<warning nil="true"/>
<application_id nil="true"/>
<amount type="integer">100</amount>
<local_amount nil="true"/>
<currency_code>USD</currency_code>
<retain_on_success type="boolean">false</retain_on_success>
<payment_method_added type="boolean">false</payment_method_added>
<smart_routed type="boolean">false</smart_routed>
<message key="messages.transaction_succeeded">Succeeded!</message>
<gateway_token>T11bJAANtTWnxl36GYjKWvbNK0g</gateway_token>
<gateway_type>test</gateway_type>
<shipping_address>
<name>Newfirst Newlast</name>
<address1 nil="true"/>
<address2 nil="true"/>
<city nil="true"/>
<state nil="true"/>
<zip nil="true"/>
<country nil="true"/>
<phone_number nil="true"/>
</shipping_address>
<response>
<success type="boolean">true</success>
<message>Successful purchase</message>
<avs_code nil="true"/>
<avs_message nil="true"/>
<cvv_code nil="true"/>
<cvv_message nil="true"/>
<pending type="boolean">false</pending>
<result_unknown type="boolean">false</result_unknown>
<error_code nil="true"/>
<error_detail nil="true"/>
<cancelled type="boolean">false</cancelled>
<fraud_review nil="true"/>
<created_at type="dateTime">2022-09-02T19:53:25Z</created_at>
<updated_at type="dateTime">2022-09-02T19:53:25Z</updated_at>
</response>
<api_urls>
</api_urls>
<payment_method>
<token>1rpKvP8zOUhj4Y9EDrIoIYQzzD5</token>
<created_at type="dateTime">2017-06-26T17:04:38Z</created_at>
<updated_at type="dateTime">2022-09-02T07:05:14Z</updated_at>
<email>[email protected]</email>
<data>
<my_payment_method_identifier>448</my_payment_method_identifier>
<extra_stuff>
<some_other_things>Can be anything really</some_other_things>
</extra_stuff>
</data>
<storage_state>retained</storage_state>
<test type="boolean">true</test>
<metadata>
<key>string value</key>
</metadata>
<callback_url nil="true"/>
<last_four_digits>1111</last_four_digits>
<first_six_digits>411111</first_six_digits>
<card_type>visa</card_type>
<first_name>Newfirst</first_name>
<last_name>Newlast</last_name>
<month type="integer">3</month>
<year type="integer">2032</year>
<address1 nil="true"/>
<address2 nil="true"/>
<city nil="true"/>
<state nil="true"/>
<zip nil="true"/>
<country nil="true"/>
<phone_number nil="true"/>
<company nil="true"/>
<full_name>Newfirst Newlast</full_name>
<eligible_for_card_updater type="boolean">true</eligible_for_card_updater>
<shipping_address1 nil="true"/>
<shipping_address2 nil="true"/>
<shipping_city nil="true"/>
<shipping_state nil="true"/>
<shipping_zip nil="true"/>
<shipping_country nil="true"/>
<shipping_phone_number nil="true"/>
<issuer_identification_number nil="true"/>
<payment_method_type>credit_card</payment_method_type>
<errors>
</errors>
<verification_value></verification_value>
<number>XXXX-XXXX-XXXX-1111</number>
<fingerprint>e3cef43464fc832f6e04f187df25af497994</fingerprint>
<stored_credential_usage>
<test>
<original_network_transaction_id>37be5367d6dbe4a88c9d</original_network_transaction_id>
<network_transaction_id>37be5367d6dbe4a88c9d</network_transaction_id>
</test>
</stored_credential_usage>
</payment_method>
<attempt_3dsecure type="boolean">false</attempt_3dsecure>
</transaction>
Gateway specific response fields
A response from Vantiv eCommerce (formerly Litle) gateway may contain an network_transaction_id
, authentication_result
, post_date
, litle_token
, card_type
, avs_response_code
, or card_validation_code
.
Note that the avs_response_code
and card_validation_code
returned uses Vantiv’s own codes, before translation into Spreedly’s standardized AVS and CVV response codes, which are also present in the base response.
You can find this information in gateway_specific_response_fields
. For example, a transaction could have:
<transaction>
<token>Y1QTi7ICTiV4EpYqCkCksUWQeJr</token>
<transaction_type>Purchase</transaction_type>
<gateway_specific_response_fields>
<litle>
<network_transaction_id>160280498621098</network_transaction_id>
<authentication_result>1</authentication_result>
<post_date>2018-02-19</post_date>
<litle_token>1234567890</litle_token>
<card_type>Credit</card_type>
<avs_response_code>00</avs_response_code>
<card_validation_code>M</card_validation_code>
</litle>
</gateway_specific_response_fields>
</transaction>
To request any gateway_specific_fields
or gateway_specific_response_fields
, please contact Support with your request and the gateway documentation for the fields of interest.
Updated about 2 months ago