API Docs – Credit Card Processing (Server to Server)


Paywiser Integration Guide

Credit Card Processing
(Server to Server)


To process a transaction using TxHandler, post a form via HTTP POST to https://merchant.paywiser.com/secure/txHandler.php. After the transaction, the user will be redirected to the redirect url and the result of the transaction will be sent to postbackurl

Payment Parameters
Name Required (Yes or No) Description
sid YES Site id (unique identifier for the web site)
tid NO Tracking id (must be unique for each transaction)
postback_url YES The URL of the page used to recieve the TxHandler postback. The response can be read from $_POST array.
redirect_url YES The URL of the page TxHandler will redirect to after processing. The response can be read as GET parameters.
hash YES md5 hash of sid+timestamp+amounttotal+currency+rcode ie:
amounttotal = (item_amount_unit[] * item_quantity ) + amount_shipping + amount_tax – amount_coupon
timestamp YES Format : hhmmss
card_type YES • amex
• visa
• mastercard
• jcb
• upi
card_no YES Credit card number
card_exp_year YES 4-digityear expiration of the credit card.(e.g. 2020)
card_exp_month YES 2-digitmonth expiration of thecredit card. (eg. 05 – May)
card_ccv YES CVV/CVC2 credit card verification code
firstname YES Frist name of the customer
lastname YES Last name of the customer
phone YES 10 to 14 numeric digits
mobile NO Mobile number
address YES Customer address
suburb_city YES Customer suburb or city
state YES Customer state, 2 digit code for US/Canada
postcode YES Customer postcode/zipcode
country YES Customer country, ISO 3166 2 digit code
uip YES Customer’s IPaddress.
currency YES Transaction currency[currency in which the gateway is setup], ISO 3 letter code
ie : USD
amount_shipping YES Transaction shipping amount. 0.00 if nothing
amount_coupon YES Coupon amount. 0.00 if nothing
amount_tax YES Transaction shipping amount. 0.00 if nothing
item_quantity[] YES Quantity of each cart item
item_name[] YES Article names for each cart item
item_no[] YES Article numbers for each cart item
item_desc[] YES Descriptions for each cart item
item_amount_unit[] YES Price per unit for each cart item in two decimal place
ref1 NO Merchant reference field
ref2 NO Merchant reference field
ref2 NO Merchant reference field
ref3 NO Merchant reference field
ref4 NO Merchant reference field
tx_action NO Value : “PAYMENT” or “PREAUTH”

The response will be sent to both redirect_url and the postback_url given in the post

Name Required (Yes or No) Description
sid String Has the sid where transaction was processed
status String Has the value “OK” for a successful transaction, or “EXC” for a failed transaction.
parent_txid String Parent transaction id
txid String The transaction ID
tx_action String The state change txaction, e.g. “PREAUTH” or “SETTLEMENT”
amount String The amount processed.
currency String The currency in which the transaction was processed
comment String Response from the gateway
descriptor String Gateway descriptor name
tid String From the original transaction
ref1 String From the original transaction
ref2 String From the original transaction
ref3 String From the original transaction
ref4 String From the original transaction
vrfy String This is a sha 256 hash so the data can be verified. To generate hash with sha256 the string of
error If an error has occurred, then the status value will equal “EXC” and these parameters will be sent as well. Detailed error will be present only if we receive it from the processing gateway.
error_type String error_type
error_sys String The system that caused the error (client or server)
error_msg String The error message
error_info String Error information that contains the bank message and bank code
error_code String error_code
Sample Form

form action=”https://merchant.paywiser.com/secure/txHandler.php” method=”post”
sid: input type=”text” name=”sid” value=””
postback_url: input type=”text” name=”postback_url” value=””
redirect_url: input type=”text” name=”redirect_url” value=””
timestamp: input type=”text” name=”timestamp” value=””
hash: input type=”text”name=”hash” value=””
firstname: input type=”text” name=”firstname” value=””
lastname: input type=”text” name=”lastname” value=””
phone: input type=”text” name=”phone”value=””
email: input type=”text” name=”email” value=””
address: input type=”text” name=”address” value=””
suburb_city: input type=”text” name=”suburb_city” value=””
state: input type=”text” name=”state” value=””
postcode: input type=”text” name=”postcode” value=””
country: input type=”text” name=”country” value=””
currency_code: input type=”text” name=”currency” value=””
amount_shipping: input type=”text” name=”amount_shipping” value=”0.00″
amount_tax: input type=”text” name=”amount_tax” value=”0.00″>
amount_coupon: input type=”text” name=”amount_coupon” value=”0.00″
card_type: input type=”text” name=”card_type” value=”allcard”
ref1: input type=”text” name=”ref1″ value=””
ref2: input type=”text” name=”ref2″ value=””
ref3: input type=”text” name=”ref3″ value=””
ref4: input type=”text” name=”ref4″ value=””
table tr td
item_quantity: input type=”text” name=”item_quantity[]” value=””
item_name: input type=”text” name=”item_name[]” value=””
item_no: input type=”text” name=”item_no[]” value=””
item_desc: input type=”text” name=”item_desc[]” value=””
item_amount_unit: input type=”text” name=”item_amount_unit[]” value=”0.00″>
/td /tr /table
input type=”submit” value=”Submit” /form