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
email 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