How do I upgrade from the Nochex Checkout System to the Payment pages?
A key consideration when releasing the new Payments Pages was to make it as easy as possible for clients using the Checkout system to upgrade to the Payments Pages. In order to assist customers wishing to upgrade from the Checkout System, the Payments page supports all of the existing parameters and actions. The simplest way to upgrade to the Payments page is to change the URL that you post your payments request to https://secure.nochex.com from https://www.nochex.com/nochex.dll/checkout/.
This mode is intended to be used for customers wishing to quickly upgrade to the Payments page. We recommend that if you wish to use the full functionality of the Payments page that you implement the new parameter name/value pairs as discussed above in pages 5-7 and shown below. NOTE: you cannot mix and match Checkout and Payments page parameter name/value pairs on the Payments page. You can either use the parameters that are required for the Checkout page or the parameters that are required for the Payments page but not a mixture of both. A comparison table is shown below.
Comparison of fields/parameters – Nochex Checkout System vs Payment Pages vs APC Fields
The following table lists the old NCS fields and shows their equivalent, Payment Page Fields and APC Fields. When upgrading to the Payment Pages, developers should change these parameters to avoid errors. Payment Page Fields marked in blue can be posted directly into the payment pages if dynamic payment page customization is required. Fields marked in red can also be posted into the payment pages, but only by Merchant Account holders.
Checkout System (NCS) Fields | Payment Page (NPP) Fields | APC Fields |
merchant_id | to_email | |
amount | amount | amount |
ordernumber | order_id | order_id |
description | description | |
logo | header_html | |
footer_html | ||
back_colour | ||
fore_colour | ||
font_name | ||
cancel_button_image | ||
continue_button_image | ||
startagain_button_image | ||
makepayment_button_image | ||
returnurl | success_url | |
cancelurl | cancel_url | |
declined_url | ||
firstname | billing_fullname | |
lastname | ||
firstline | billing_address | |
town | ||
county | ||
postcode | billing_postcode | |
delivery_fullname | ||
delivery_address | ||
delivery_postcode | ||
customer_phone_number | ||
email_address_sender | email_address | from_email |
responderurl | callback_url | |
security_key | ||
test_transaction | status | |
test_success_url | ||
transaction_id | ||
transaction_date | ||
postage | ||
insurance | ||
custom | optional_1 | custom |
optional_2 | ||
optional_3 | ||
optional_4 | ||
optional_5 | ||
ask_more_info_caption | ||
ask_more_info |