Transaction Cancellation Service

Android Pos Transaction Cancellation Service

Android Pos Transaction Cancellation Service; It is the service used to cancel successfully completed transactions.

Method	API URL	Parameter
POST	https://posservice.esnekpos.com/api/services/OrderReturnPhysical	JSON File

The parameters to be sent to the service are as follows;

Android Pos Payment Service Request Message Parameters

Config

Parameters	Type	Compulsory	Description
MERCHANT	string	Yes	It is a unique credential created specifically for the member business.
MERCHANT_KEY	string	Yes	It is the key information created specifically for the member business.
BACK_URL	string	Yes	It is the address information to which the operation result response will be returned by the system. Transaction response will be read from this address by the member business. The result of the process is sent as a form post.
ORDER_REF_NUMBER	string	Yes	It is the reference number information to be given by the member workplace. Payment transactions can be tracked with this reference number. A maximum of 24 characters can be used.

Here is a sample JSON file to send to the service;

                                            
{
        "MERCHANT": "TEST1234",
        "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
        "BACK_URL": "https://posservicetest.esnekpos.com/api/home/PhysicalPaymentLog",
        "ORDER_REF_NUMBER": "ORDER_REF_NUMBER"
}
                                            
                                        

Android Pos Transaction Cancellation Service Reply Message;

The parameters of the reply message sent from the service after the transaction are as follows;

Android Pos Payment Service Request Message Parameters

Config

Parameters	Type	Compulsory	Description
RETURN_CODE	string	Yes	Inquiry operation result status code information.
RETURN_MESSAGE	string	Yes	Status message information as a result of the query process.
STATUS	string	Yes	It is status information.
ORDER_REF_NUMBER	string	Yes	It is the reference number information to be given by the member workplace. Payment transactions can be tracked with this reference number. A maximum of 24 characters can be used.
REFNO	string	Yes	The reference number information given by the Esnekpos system for the payment transaction

                                            
{
        "RETURN_CODE": "0",
        "RETURN_MESSAGE": null,
        "STATUS": "SUCCESS",
        "ORDER_REF_NUMBER": "ORDER_REF_NUMBER",
        "REFNO": "REFNO"
} 
                                            
                                        

If the value of STATUS parameter is SUCCESS and the value of RETURN_CODE parameter is 0 in the Android pos transaction cancellation service reply message, it means that the Android Pos transaction cancellation service has been performed successfully.

Status information that can be returned from the service;

RETURN_CODE	STATUS	DESCRIPTION
0	SUCCESS	it's successful operation.
100	ERROR	it's unsuccessful operation.
102	AUTHENTICATION_ERROR	authentication error.
105	INSERT_ERROR	This message is returned for errors in the log records.
300	ORDER_CANCEL	This message is returned for errors in the logs.
999	UNKNOWN_ERROR	An unexpected error has occurred.