Paywiser - 獲取 API

HTTP Request

POST https://office.paywiser.com/api/v1/index.php/{sid}/singletx

										
<?php
$request['sid']="27";
$rcode ="xxxxxxxx"; 
$request['card_type'] = 'visa'; 
$request['email'] = '[email protected]'; 
$request['tx_action'] ='PAYMENT';
$request['card_no'] = '4111111111111111'; // or the ref no account authorize transaction eg. 58-9-2036956
$request['card_ccv'] = '123';
$request['card_exp_month'] = '11';
$request['card_exp_year'] = '2022';
$request['card_name'] = 'test';
$request['firstname'] = 'ALan';
$request['lastname'] = 'Lai';
$request['phone'] = '123445666';
$request['email'] = '[email protected]';
$request['address'] = 'xxx';
$request['suburb_city'] = 'xxx';
$request['state'] = 'xxx';
$request['postcode'] = 'xxx';
$request['country'] = 'MY';
$request['timestamp'] = '0123456789'; 
$request['currency'] = 'USD';
$request['tid'] = '1234567892'; 
$request['amount_shipping'] ='0.00'; 
$request['amount_coupon'] ='0.00';
$request['postback_url'] ="http:// testpostbackreturn.php"; 
$request['amount_tax'] ='0.00'; 
$request['item_quantity[]']= '1';
$request['item_name[]'] = 'NA';
$request['item_no[]'] = 'NA';
$request['item_description[]'] = 'NA';
$request['item_amount_unit[]'] ='10.00';
$item_quantity = $request['item_quantity[]'];
$item_amount_unit = $request['item_amount_unit[]'];
$amounttotal = $item_quantity * $item_amount_unit;
$amounttotal = $amounttotal + $request[amount_tax] + $request[amount_shipping] -$request[amount_coupon]; 
$amounttotal='10.00';
$request[hash] = md5($request['sid']. $request[timestamp] . $amounttotal . $request[currency] . $rcode);
if(!$curl = curl_init('http://office.paywiser.com/api/v1/index.php/27/singletx')) echo "cURL initialization failure:
".curl_error($curl);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request)); curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 0);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
if ( !$response = curl_exec($curl))
echo "cURL execution failure: ".curl_error($curl);

curl_close ($curl);
echo "Response: "; echo "
<pre>"; print_r($response); echo "</pre>";

Non 3D Asynchronous Response Sample:

										
{
   "sid":"27",
   "status":"OK",
   "parent_txid":"1234567",
   "txid":"7654321",
   "tx_acti on":"PAYMENT",
   "amount":"10.00",
   "currency":"USD",
   "tid":"1234567892",
   "ref1":" ",
   "ref2":"",
   "ref3":"",
   "ref4":"",
   "comment":"\"Payment Success\"",
   "descriptor":"AcqraS2S USD",
   "rebillkey":"",
   "settlementamount":"10.00",
   "settlementcurrency":"USD",
   " paymentinfo":""
}

3D Asynchronous Response Sample :

										
{
	"sid":"xx",
	"status":"REQ",
	"parent_txid":"1619750629xxxxx",
	"txid":"16197506 369xxxx",
	"tx_action":"PAYMENT",
	"amount":"1.00",
	"currency":"USD",
	"tid":"",
	"ref1":"{\"webUrl\":\"https:\\\/\\\/oats.allinpay.com\\\/payh5\\\/cnp_pay\\\/ directCashier?accessCode=xxxxx&mchtId=852999956xxxxx&accessOrderId=21043010 4353xxxxxx&language=en\"}",
	"ref2":"",
	"ref3":"",
	"ref4":"",
	"comment":"",
	"descriptor":"PF_VISA_USD_NEW",
	"rebillkey":"",
	"error":{
  	"type":"WAIT3D",
  	"sys":"",
  	"msg":"Awaiting 3DSecure",
  	"info":"{\"webUrl\":\"https:\\\/\\\/oats.allinpay.com\\\/payh5\\\\ /cnp_pay\\\/directCashier?accessCode=85200061&mchtId=852999956610024&access OrderId=2104301043530790477&language=en\"}",
  	"code":""
	},
	"settlementamount":"0.00",
	"settlementcurrency":"USD",
	"paymentinfo":""
}

Query Parameters

Table of query parameters information
Parameter	Required	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	No	Only required for 3D flow
hash	Yes	md5 hash of strings concatenation from sid + timestamp + amounttotal + currency + rcode e.g. (in PHP): md5(‘22’.‘1234568995265421’.‘17.00’.‘CNY’.‘222b6c’) REMARK : amounttotal = (item_amount_unit * item_quantity ) + amount_shipping + amount_tax – amount_coupon
timestamp	Yes	Format : hhmmss
card_type	Yes	• amex , • visa , • mastercard , • jcb , • upicard , • allcard (use this one for server to server integration)
card_no	Yes	Credit card number, In case of double acquiring payment it will be the transaction reference from the authorize transaction and no need for the rest card info.
cart_exp_year	condition	4-digityear expiration of the credit card.(e.g. 2020)
card_exp_month	condition	2-digitmonth expiration of the credit card. (eg. 05 – May)
card_ccv	condition	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	Yes	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
ref3	No	Merchant reference field
ref4	No	Merchant reference field
tx_action	No	Value : “PAYMENT”

Instant Response

Instant response will be sent once the Payment proceed by system.

Table of instant response information
Parameter	DataType	Description
sid	String	Has the sid where transaction was processed
status	String	OK – successful , EXC – failed , REQ – pending for 3D authentication. Only for 3D channel
parrent_txid	String	Parent transaction id
txid	String	The transaction ID
tx_action	String	Default Value - PAYMENT
amount	String	The amount processed.
currency	String	The currency in which the transaction was processed
comment	String	Description of the transaction
descriptor	String	Gateway descriptor name
error[type]	String	“WAIT3D” - Only for 3D channel
error[msg]	String	“Awaiting 3DSecure” - Only for 3D channel
error[info][webUrl]	String	3Ds url – please redirect user to the url given for the 3Ds authentication. Only for 3D channel

Postback Response

Instant response will be sent once the Payment proceed by system.

Table of postback response information
Parameter	DataType	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.
parrent_txid	String	Parent transaction id
txid	String	The transaction ID
tx_action	String	Tx_action = PAYMENT
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
error	String	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	“WAIT3D” - Only for 3D channel
error_msg	String	The error message
error_sys	String	The system that caused the error (client or server)
error_info	String	Error information that contains the bank message and bank code
error_code	String	error_code
vrfy	String	This is a sha 256 hash so the data can be verified to ensure your post back data was not modified. To generate hash with sha256 the string of sid;rcode;txid;status;amount;currency;txaction

Redirect Solution

To process a transaction using TxHandler, post a form via HTTP POST to https://office.paywiser.com/secure/txHandler.php. During the transaction, the user will be redirected to make payment and then send back to a user defined location and the result of the transaction can be received as postback to a user defined script/page

Query Parameters

Table of query parameters information
Parameter	Required	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 strings concatenation from sid + timestamp + amounttotal + currency + rcode e.g. (in PHP): md5(‘22’.‘1234568995265421’.‘17.00’.‘CNY’.‘222b6c’) REMARK : amounttotal = (item_amount_unit * item_quantity ) + amount_shipping + amount_tax – amount_coupon
timestamp	Yes	Format : hhmmss
card_type	Yes	allcard
firstname	Yes	Frist name of the customer
lastname	Yes	Last name of the customer
phone	Yes	10 to 14 numeric digits
email	Yes	Email
mobile	No	Mobile number
uip	Yes	Customer’s IP Address
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
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
ref3	No	Merchant reference field
ref4	No	Merchant reference field
tx_action	No	Ie : “PREAUTH”

Instant Response

There will be two responses one with tx_action =PREAUTH and another with tx_action = SETTLEMENT.

The transaction is completed when you receive the response with tx_action=SETTLEMENT The response will be sent to both redirect_url and the postback_url given in the post.

Table of instant response information
Parameter	DataType	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.
parrent_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 ensure your post back data was not modified. To generate hash with sha256 the string of sid;rcode;txid;status;amount;currency;txaction
error	String	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
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

HTTP Request

POST https://office.paywiser.com/secure/txHandler.php

									
<form action="https://office.paywiser.com/secure/txHandler.php" method="post">
    sid: <input type="text" name="sid" value=""><BR>
    postback_url: <input type="text" name="postback_url" value=""><BR>
    redirect_url: <input type="text" name="redirect_url" value=""><BR>
    timestamp: <input type="text" name="timestamp" value=""><BR>
    hash:<input type="text" name="hash" value=""><BR>
    firstname: <input type="text" name="firstname" value=""><BR>
    lastname:<input type="text" name="lastname" value=""><BR>
    phone: <input type="text" name="phone" value=""><BR>
    email: <input type="text" name="email" value=""><BR>
    address: <input type="text" name="address" value=""><BR>
    suburb_city:<input type="text" name="suburb_city" value=""><BR>
    state:<input type="text" name="state" value=""><BR>
    postcode: <input type="text" name="postcode" value=""><BR>
    country:<input type="text" name="country" value=""><BR>
    currency_code: <input type="text" name="currency" value=""><BR>
    amount_shipping: <input type="text" name="amount_shipping" value="0.00"><BR>
    amount_tax: <input type="text" name="amount_tax" value="0.00"><BR>
    amount_coupon: <input type="text" name="amount_coupon" value="0.00"><BR>
    card_type: <input type="text" name="card_type" value="allcard"><BR>
    ref1: <input type="text" name="ref1" value=""><BR> ref2: <input type="text" name="ref2" value=""><BR>
    ref3: <input type="text" name="ref3" value=""><BR> ref4: <input type="text" name="ref4" value=""><BR>
    <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="hidden" name="tx_action" value="PREAUTH">
    <input type="submit" value="Submit">
</form>

Acquiring API

Credit Card Processing

Server To Server

HTTP Request

Non 3D Asynchronous Response Sample:

3D Asynchronous Response Sample :

Query Parameters

Instant Response

Postback Response

Redirect Solution

Query Parameters

Instant Response

HTTP Request