Refund Transaction

Refund Transaction means the user requesting refund for completed transactions. To enable this refund should verify that acquiring banks that use already support the process of refund and the bank is already integrated with faspay. Refund requests can only be made for transactions already Capture atau Sales (TXN_STATUS = C atau S).

Not All bank allow this refund process via API, some of them processe through email

Request Parameter Transaction Refund

Request Parameter Transaction Refund are parameters that must be provided by the merchant's system can conduct transactions through the system Faspay refund.

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 adjust status API, always used value ‘11’
merchantid	Varchar(30)	M	Your Faspay e-Payment Merchant ID
merchant_tranid	Varchar(100)	M	Your own assigned unique ID for transaction. The value must match the original value submitted in; otherwise the request will be rejected with error.
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
refund_amount	Numeric	M	The amount to refund the transaction. The value must equal or less than original amount.
response_type	Varchar(1)	M	Indicate how the system should provide the transaction result. Please always use the value ‘3’ for Credit Card refund 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(
"TRANSACTIONTYPE"           => '11',
"RESPONSE_TYPE"             => '3',//                          
"MERCHANTID"                => 'sophia_store',                             
"PAYMENT_METHOD"            => '1',
"MERCHANT_TRANID"           => '3180550000000091',       
"TRANSACTIONID"             => '691FCAFC-BFE3-47A5-A4F0-B2C21AB589FE',
"AMOUNT"                    => '1000.00',
"REFUND_AMOUNT"             => '1000.00', 
"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 Refund

Response parameter transaction refund are parameters that will be delivered by the system Faspay in response to a request a refund transaction parameters that have 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 refund request, the transaction status will remain C – Capture successfully / S - Sales
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.
acquirer_id	Varchar (30)	O	Your Faspay e-Payment Acquirer ID
refund_date	Varchar (19)	C	Transaction date of when transaction is refunded in Faspay e-Payment. Date format in ‘DD-MM-YYYY hh:mm:ss’ e.g. 24-05-2006 08:24:23. This parameter will only be provided if transaction status is successfully refunded.
refund_amount	Numeric	M	Transaction refund amount as passed in from the request.
total_refund_amount	Numeric	M	The total of refund amount that already done for the transaction. If the transaction not doing any refund, will return 0.
bank_res_code	Varchar(20)	C	Response code or error code from bank. In the event of error, this field may be empty.
bank_res_msg	Varchar(250)	C	Bank description on the response based on BANK_RES_CODE. In the event of error, this field may be empty.