Pipelining Data Back to Another Server or Process
This process allows certain specified form fields to be passed back to another URL (in the background) after the Vcheck form has been submitted. This is useful for passing desired form field pairs (name and value) back to another script for processing. For instance, if you desire to have a different database containing all your sales information on your own server, you may use this process to send some or all of the form fields sent from your original form sent back to another script on your server.
This is accomplished with the use of two hidden input fields in your ordering system that are used when calling the Vcheck form.
<input type="hidden" name="returnurl" value="THE RETURN PATH HERE"> <input type="hidden" name="returnfields" value="THE NAMES OF THE FORM FIELDS YOU WISH RETURNED, SEPARATED BY COMMAS - BUT NOT SPACES">
To further explain, the Vcheck system will know that once the Vcheck form is submitted by your customer, a HTTP(s) Post should be made to the "redirecturl" provided in your link to launch the Vcheck form. That post will contain the form field pairs (name / value) for all the field names you request in the "redirecfields" value. These can be any of the form fields that Vcheck uses (amount, memo, etc), or ones that you send as part of your form.
For instance, we have a customer with a custom e-commerce system that collects a down-payment for their auto transport service. Through their own background programming, the link to the actual Vcheck form contains the following:
<input type="hidden" name="redirecturl" value="https://www.autotransportsample.com/quote6_check.asp"> <input type="hidden" name="redirectfields" value="orderid,amount">
So, the above fields are written as hidden input fields on the actual Vcheck form - and when submitted, the form field pairs (form field name and value) for "orderid" and "amount" are passed back to their custom system indicating that the payment has been completed.
PLEASE NOTE: This method will only pass the data back to a URL in the background, it will NOT transfer the user back to the URL. The last page they see will be the confirmation page from their check submission. If you wish for the user and specified form field pairs to be sent to a different URL, see the "Redirecting to URL" section.
