Transaction Void

Transaction void means that the user refuse / reject the transaction or commonly known as a reversal, the void can be done online or offline depending on each bank's services. Reversal is done on the same day before the cut off set by the bank, for example, if the cut-off transaction at 20:00 the night then the process void conducted under these hours will be accepted but if the void is done after the cut off bank then faspay will provide information notification to the merchant that the void fails with code 5621 (Void rejected by bank).

Not all banks support these Feature, please ensure that use merchant acquiring banks already exist those features and has been working with Faspay. Merchant can mark the transaction void or canceled through the features provided FPG. FPG is a payment gateway system that serves to communicate directly with the bank system, which can void the transaction is a transaction with status

N = Pending / Waiting

A = Authorize (authorize transactions in the bank

RC = Status of the bank is not known, the user must confirm return for the transaction

Request Parameter Transaction Void

Request parameter is a void transaction parameters that must be provided by the merchant's system can conduct transactions through the system Faspay void.

Request

Parameter	Data Type	M/O/C	Description
payment_method	Varchar(1)	M	Indicate payment method used. Always used value ‘1’ for credit card payment.
transactiontype	Varchar(2)	M	For credit card void API, always used value ‘10’.
merchantid	Varchar (30)	M	Your Faspay e-Payment Merchant ID
transactionid	Integer	M	Faspay e-Payment assigned transaction id during authorization request.
amount	Numeric	M	Original amount of transaction. Supports up to 2 decimal point. E.g. for RM 52.50, pass in value as 52.50, for IDR 10000, pass in value as 10000.00. The value must match the original amount submitted in; otherwise the request will be rejected with error.
response_type	Varchar(1)	M	Indicate how the system should provide the transaction result. Please always use the value ‘3’ for Credit Card void API. The response parameters will be directly printed to stream with ‘;’ as separator for each response parameter. The sequence of the parameter may be different from one release to another, please do not rely on the sequence of parameter to process response.
signature	Varchar(40)	M	Transaction signature of request for data integrity check.

Sample Request

<?php

$tranid = date("YmdGis");
$signaturecc=sha1('##'.strtoupper('sophia_store').'##'.strtoupper('ymzfogbo').'##3180550000000091##1000.00##'.'691FCAFC-BFE3-47A5-A4F0-B2C21AB589FE'.'##');
$post = array(
"PAYMENT_METHOD"        => '1',
"TRANSACTIONTYPE"       => '10',                       
"MERCHANTID"            => 'sophia_store',                               
"MERCHANT_TRANID"       => '3180550000000091',       
"TRANSACTIONID"         => '691FCAFC-BFE3-47A5-A4F0-B2C21AB589FE',
"AMOUNT"                => '1000.00',
"RESPONSE_TYPE"         => '3', 
"SIGNATURE"             => $signaturecc 
);

$string = '<form method="post" name="form" action="https://fpg.faspay.co.id/payment/api">'; 
if ($post != null) {
foreach ($post as $name=>$value) {
$string .= '<input type="hidden" name="'.$name.'" value="'.$value.'">';
}
}

$string .= '</form>';
$string .= '<script> document.form.submit();</script>';
echo $string;
exit;

Response Parameter Transaction Void

Response Parameter Transaction Void are parameters that will be delivered by the system Faspay in response to a request parameter void transaction that has been submitted by the merchant system. If no parameters are not appropriate / value is incorrect, the transaction will be rejected in the system Faspay.

Parameter	Data Type	M/O/C	Description
payment_method	Varchar (1)	M	Indicate payment method used. For credit card payment, value ‘1’ is returned
transactiontype	Varchar(2)	M	Return transaction type as passed in from request
merchantid	Varchar (30)	M	Your Faspay e-Payment Merchant ID
merchant_tranid	Varchar(100)	M	Merchant’s own assigned transaction id
err_code	Varchar(10)	M	Error Code returns from Faspay e-Payment. If transaction is successful, this value will be 0. Any other value than 0 will indicate that the transaction is not successful
err_desc	Varchar(250)	M	Error description from Faspay e-Payment based on the ERR_CODE.
usr_code	Varchar(4)	C	User Code returns from Faspay e-Payment. A user code will be used to indicate the appropriate action to be taken by shopper according to different bank response code obtained. In the case of pending status, this value is will an empty value
usr_msg	Varchar(200)	C	User Message returns from Faspay e-Payment. A user message will be used to indicate the appropriate action to be taken by shopper according to different bank response code obtained. In the case of pending status, this value is will an empty value
txn_status	Varchar(2)	M	Transaction status. Please refer to Appendix B for full list of transaction status. For Void API, the possible status returned include following: V – Status adjusted to ‘Void’ E – Error occurred. Check ERR_CODE and ERR_DESC The txn_status in system shall remain as the original status prior to sending for void. The TXN_STATUS “E” in this response is just to indicate the result of the void request
amount	Numeric	M	Transaction amount as passed in from the request.
transactionid	Integer	M	Faspay e-Payment’s assigned transaction id. In the event of error, this field may be returned as 0.
signature	Varchar(40)	M	Transaction signature of response for data integrity check.
is_on_us	Varchar(3)	M	Indicate whether the transaction is using on us card. Value is ‘Yes’ or ‘No’