Nochex Support

Whatever your question, we're here to help!

Frequently Asked Questions

Callback

Callback

Callback allows you to integrate your Nochex payments with your website's back-end operations, so you get immediate confirmation and authentication of the Nochex payments you receive. It's very similar to our Nochex APC system. It allows you to:

• Process your customers payments in real-time

• Give immediate feedback to your customer

• Store your Nochex payments in your own database

Callback can be integrated into the Nochex checkout system to allow you to create a payment system that alleviates the need for you to log into the Nochex system to confirm that payments have been made. The customer will also benefit from the Callback as they will receive an immediate response to the order they have placed, similar to that of making payments through a credit card system.

How does the Nochex Callback work?

The Nochex Callback system works by sending a confirmation POST to a page on your server. Once your server has received a response from our servers, you can process the information to allow you to construct an email or update an order on your website / shopping cart in relation to a payment that has been made, and whether it has been a AUTHORISED or DECLINED transaction.

How do I apply for Callback?

To use the Callback functionality - you will need to contact support who can enable this feature for you.

How do I change the Callback URL that Nochex send the confirmations to?

If you are a Merchant account holder and wish to amend the URL Nochex POST their confirmations to follow these steps:-

• Login to your NOCHEX account

• Click on the 'Payments Page Setup' link
• Edit the URL in the 'CallBack' textbox
• Press "Save Changes" button

OR

you can send the Callback details with your checkout parameters, for example:

callback_url=http://your.url.here/responder.asp [Callback responder address]

How do I integrate the Nochex Callback into my site?

For detailed instructions on integrating the Callback system into your website please download the following integration document:

Click here to view the Callback Integration Guide

What information can be retrieved from the Nochex Callback System?

The following information can be retrieved from the CALLBACK system

Variable

Value

Description

transaction_date

Transaction specific

Date/time stamp of transaction.

transaction_id

Transaction specific

Unique code generated to distinguish transactions.

security_key

Transaction specific

System generated key (for Nochex use).

amount

Transaction specific

Amount received into Nochex account after charges. (same as net amount)

gross_amount

Transaction specific

Full amount of the customers payment

order_id

Transaction specific

Transaction specific code, order id as passed by you, the merchant. Your customer is not able to view or edit this. It must be unique per transaction.

merchant_id

Transaction specific

Merchant Alias of the payment recipient.

email_address

Transaction specific

Email address of the payment sender.

postage

Transaction specific

Postage amount for transaction

insurance

Transaction specific

Insurance amount for transaction

optional_1

Transaction specific

Optional field submitted by merchant

optional_2

Transaction specific

Optional field submitted by merchant

optional_3

Transaction specific

Optional field submitted by merchant

optional_4

Transaction specific

Optional field submitted by merchant

optional_5

Transaction specific

Optional field submitted by merchant

transaction_status

0=Live , 100=test

Used to distinguish a test transaction where no money has been sent, from a live transaction where money has been sent.

billing_fullname

Transaction specific

Billing name of customer

billing_address

Transaction specific

Billing address of customer

billing_postcode

Transaction specific

Billing postcode of customer

delivery_fullname

Transaction specific

Customer Delivery name

delivery_address

Transaction specific

Customer Delivery address

delivery_postcode

Transaction specific

customer delivery postcode

customer_phone_number

Transaction specific

customer phone number

consumer_message

Transaction specific

customer message entered on payment page

ip_address

Transaction specific

Ipaddress of customer

ip_country

Transaction specific

Country IP address based in

card_country

Transaction specific

Country debit / credit card issued

card_address_check

Not Checked, Failed, Not Available, Passed

Address verification result. NotChecked = AVS Check Bypassed, Failed = Address not match, Passed = Address match, Not Available = AVS not available for card

card_postcode_check

Not Checked, Failed, Not Available, Passed

Address verification result. NotChecked = AVS Check Bypassed, Failed = postcode not match, Passed = postecode match, Not Available = AVS not available for card

card_security_code

Not Checked, Failed, Not Available, Passed

CVV2 result. NotChecked = AVS Check Bypassed, Failed = CVV2 not match, Passed = CVV2 match, Not Available = CVV2 check unavailable for card

3d_secure_validation_check

Fully Authenticated, Authentication Attempted, No Authentication Attempted

3D Secure result. Fully Authenticated = 3DS Full Pass , Authentication Attempted = Attempted 3DS Check ,No Authentication Attempted = 3DS check bypassed

net_amount

Transaction specific

Amount received into Nochex account after charges. (same as amount)

charge

Transaction specific

Nochex charge for transaction


Examples of Callback

The examples below show how the Callback system works, and you will receive an email informing you of the parameters, and whether the transaction has been Authorised or Declined.

VB/ASP Example
PHP Example
Last Updated 3 years ago

Can't find what your looking for? Try searching

Please Wait!

Please wait... it will take a second!