Single Transaction API (TxHandler)

post

https://uat.txshield.payshield.ai/secure/txHandler.php

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

After the transaction, the user can be redirected to a user defined location and also the result of the transaction can be received as postback to a user defined script/page.

For more information click the following link: Make Payment using TxHandler.

No Redirect URL

In case of no redirect url, the response will be a json string of the above mentioned array. This will be useful if you are using CURL post instead of FORM post. The status field will have one of the following values:

OK
The transaction was successful.

PEND
The transaction is pending and there will be a follow-up message.

EXC
The transaction is declined. The response should include information about the reason or exception encountered.

PAYG_ERROR
This is a rare response, indicating a problem with communicating with the processor.

Form Data

sid

string

required

Site id (unique identifier for the web site)

tid

string

Merchant Reference

postback_url

string

required

The URL of the page used to receive the TxHandler postback. The response can be read from $_POST array.

redirect_url

string

The URL of the page TxHandler will redirect to after processing. The response can be read as GET parameters. If there is no redirect_url, the result will be a json string

hash

string

required

md5 hash of sid+timestamp+amounttotal+currency+rcode ie: md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')

timestamp

string

required

Timestamp value used in the hash ie: 1234568995265421

card_type

string

required

Please ask your support contact for your complete list. Each pay method will require different fields and currencies to be entered.

card_name

string

required

Card holder name

card_no

string

required

No spaces or dashes allowed

card_ccv

string

required

Card CCV

card_exp_month

string

required

2 digits

card_exp_year

string

required

4 digits

institution_number

string

The institution number, used for bank transfers

routing_no

string

The routing or transit number, used for bank transfers

account_no

string

The account number, used for bank transfers

firstname

string

First name of the customer

lastname

string

Last name of the customer

phone

string

Customer phone number

string

required

Customer email

mobile

string

Customer mobile number

address

string

Customer address

suburb_city

string

Customer suburb or city

state

string

Customer state, 2 digit code for US/Canada

postcode

string

Customer postcode/zipcode

country

string

required

Customer country, ISO 3166 2 digit code

shipping_firstname

string

First name of the customer

shipping_lastname

string

Last name of the customer

shipping_address

string

Customer address

shipping_suburb_city

string

Customer suburb or city

shipping_state

string

Customer state, 2 digit code for US/Canada

shipping_postcode

string

Customer postcode/zipcode

shipping_country

string

Customer country, ISO 3166 2 digit code

currency

string

required

Transaction currency [currency in which the gateway is setup], ISO 3 letter code

amount_shipping

string

required

Transaction shipping amount

amount_coupon

string

required

Coupon amount

amount_tax

string

required

Transaction tax amount

threeDSecure

string

json string of the 3d2.0 params eg, {"eci":"05", "cavv":"MPUAANABhSD54fFQJTIm+Vq+zPY=", "xid":"1b5705e7-70da-4a63-9693-bba49da82066", "status":"Y", "protocolVersion":"2.1.0", "authenticationValue":"MPUAANABhSD54fFQJTIm+Vq+zPY=", "dsTransactionId":"1b5705e7-70da-4a63-9693-bba49da82066"}

campaignid

string

This is a campaign code as provided by the associated affiliate system. please only use if information is provided.

affiliateid

string

The affiliate id provided by the affiliate system

ref1

string

Merchant reference field

ref2

string

Merchant reference field

ref3

string

Merchant reference field

ref4

string

Merchant reference field

tx_action

string

PAYMENT/PREAUTH/AUTH