Recurring Postback
This function assumes that you are familiar with CGI scripting.
Related Links: Recurring Billing
As always, test your forms before making them live.
If you use the recurring transaction features of the gateway, you may specify a URL to receive transaction postback information. This can be enabled via the "Account Settings" link in the Control Panel.
To use this feature, enter the URL to be used for postback information. Then select the check-box for recurring. Each time a recurring transaction is processed through our system, our server will post the transaction results to your URL. The fields listed below will be available to your script when the postback function is used. Please note that not all fields will be posted in every postback
Transaction Details:
- xid
- Transaction ID
- authcode
- Credit card authorization code if status is 'ok'
- avs_response
- Address verification response (Only on card transacitons)
- cc_last_four
- Last four digits of the card number (Only on card transacitons)
- cc_name
- Name of the credit card type used; possible values are: "Visa", "MasterCard", "American Express",or "Discover" (Only on card transactions)
- cvv2_response
- The CVV response (Only on card transacitons)
- trans_type
- order
- when
- Time/date stamp in format of "20010509134443" - meaning 05/09/2001 at 13:44:43
- status
- Possible values are: "ok", "error", "fail", or "begun"
- error_message
- cust_id
Recurring Details:
- recipe_name
- recipe_every
- recipe_period
- orig_xid
- Name of recipe
- rem_reps
- Remaining repetitions.
- start_date
- on_hold
- 1 for Yes 0 for No.
- billing_update_token
- 60-80 character hash.
Recurring Items:
Item specifics for recurring transactions are passed back in the following format:
- 1-desc, 1-cost, 1-qty, 1-x, 2-desc, 2-cost, ...
- Where x would be a user specified item attribute
There are three different scenarios for the values of these fields:
- No recur_total, recur_desc passed with original trans These items will reflect the item set passed through with the original order form
- recur_total, recur_desc passed with original trans 1-cost will be equal to recur_total, 1-desc will be equal to recur_desc, 1-qty will be 1
- Manually scheduled recurring transaction These items will reflect the items that were specified while scheduling the manual recipe
- recur_desc
- Deprecated but still value of 1-desc
- recur_total
Customer Information:
- first_name
- Returns the billing first name
- last_name
- Returns the billing last name
- address
- Returns the billing street address
- city
- Returns the billing city
- state
- Returns the billing city
- zip
- Returns the billing zip
- ctry
- Returns the billing country
- phone
- Returns the billing phone
- Returns the billing email
Shipping Information:
- sfname
- Returns the shipping first name
- slname
- Returns the shipping last name
- saddr
- Returns the shipping street address
- scity
- Returns the shipping city
- sstate
- Returns the shipping state
- szip
- Returns the shipping zip
- sctry
- Returns the shipping country