Save Meta-Data Function
Read the RESTRICTIONS below before using this function. As always, test your forms before making them live.
This simple feature enables merchants to save their own transaction data on the gateway. This feature is typically used to save fields such as the fields requested using the "Passback" function. This data can be used to search for transactions using the advanced transaction search and is displayed in the transaction details page. This data is not currently returned in the CSV report, but is returned in the XML report.
The following fields are already saved on the gateway system and do not need to be requested using this function:
- first_name
- Billing first name
- last_name
- Billing last name
- address
- Billing street address
- city
- Billing city
- state
- Billing city
- zip
- Billing zip
- country
- Billing country
- phone
- Billing phone
- Billing email
- sfname
- Shipping first name
- slname
- Shipping last name
- saddr
- Shipping street address
- scity
- Shipping city
- sstate
- Shipping state
- szip
- Shipping zip
- sctry
- Shipping country
- authcode
- Credit card authorization code
- cc_last_four
- Last four digits of the card number
- ck_last_four
- Last four digits of the checking account number
- cc_name
- Name of the card type used. "Visa", for example
- total
- Transaction total.
- when
- Time/date stamp in format of "20010509134443" - meaning 05/09/2001 at 13:44:43
- xid
- Transaction ID
- avs_response
- Address verification response
- cvv2_response
- CVV response
Example
To use this Function, simply add the following HTML code to your order form with the appropriate field name:
<INPUT type="hidden" name="save" value="ordernum">
<INPUT type="hidden" name="ordernum" value="order#999">
<INPUT type="hidden" name="passback" value="ordernum">
Restrictions
- While in test mode, no meta-data is saved. Data is only saved when a transaction processes live.