Store Credit Reduction

Mağaza Alacak Azaltma Servisi İstek Modeli;

Method	API URL	Parameter
POST	http://posservicetest.esnekpos.com/api/services/AddSubMerchantAmount	JSON File

The amount owed by the store (submerchant) transmitted at the time of collection can be reduced later.

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

Parameters	Type	Compulsory	Descripiton
MERCHANT	string	Yes	It is a unique credential created specifically for the merchant (Marketplace).
MERCHANT_KEY	string	Yes	It is the key information created specifically for the merchant (Marketplace).
ORDER_REF_NUMBER	string	Yes	It is the reference number information given by the merchant (Marketplace) when sending the payment transaction request. The payment transaction to be canceled is matched with the reference number of the relevant merchant, and the transaction is carried out.
EXTERNAL_ID	string	Yes	It is the ID information in the marketplace (merchant) system of the store (submerchant). This information is assigned by the marketplace.
AMOUNT	int	Yes	It is the information of the amount to be reduced for the reference number to be processed.

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

                                            
{
    "MERCHANT": "TEST1234",
    "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
    "ORDER_REF_NUMBER": "412",
    "EXTERNAL_ID": "EXTERNAL_ID1",
    "AMOUNT": -5
}
                                        

Store Credit Reduction Service Reply Message;

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

Parameters	Type	Compulsory	Description
RETURN_CODE	string	Yes	The status of the credit reduction operation is the code information.
RETURN_MESSAGE	string	Yes	It is the status message information as a result of the credit reduction operation.
STATUS	string	Yes	Status information as a result of the credit reduction operation.
ORDER_REF_NUMBER	string	Yes	It is the reference number information given for the request in the payment request by the merchant (Marketplace).
REFNO	string	Yes	It is the reference number information given by the FlexPos system for the credit reduction transaction.

                                            
{
    "RETURN_CODE": "00",
    "RETURN_MESSAGE": "5,00 ₺ alt mağaza alacağına eklenmiştir.",
    "STATUS": "SUCCESS",
    "ORDER_REF_NUMBER": 412,
    "REFNO": null
}
                                        

The return of STATUS parameter to SUCCESS and RETURN_CODE parameter to 0 in the store credit reduction request response message indicates that the reduction process was successful.