Capture Transaction

Capture transaction means that the user approve / approve credit card transactions that have been verified bank (authorize transactions), the merchant then sends a request to capture the transaction to receive and collect the payments to customers who registered on the credit card used. Requests capture can only be made for transactions already in the authorize by the bank (field TXN_STATUS = A). In some banks already provide services for the automation of the capture process that can be set in accordance with merchant demand.

Request Parameter Capture Transaction

Request parameter capture the transaction is a parameter that must be provided by the merchant system to be able to capture transactions through the system Faspay.

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 capture API, always used value ‘2’.
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.
response_type	Varchar(1)	M	Indicate how the system should provide the transaction result. Please always use the value ‘3’ for Credit Card capture 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

Response Parameter Capture Transaction

Response transaction capture parameters are parameters that will be delivered by the system in response to a request Faspay capture parameter 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 capture request, the possible status returned only include following: C – Capture successfully CF – capture failed
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
is_on_us	Varchar(3)	M	Indicate whether the transaction is using on us card. Value is ‘Yes’ or ‘No’
bank_res_msg	Varchar(50)	O	Bank description on the capture request.
capture_date	Varchar (19)	C	Transaction date of when transaction is captured 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 captured.