Billing (Transaction) Services

Those are the services that can be used by the merchant in order to "query" and to "cancel" the transactions on Payguru Platform for its services.


1. Get Transaction Detail

It is the service that enables the merchant to query Payguru Platform in order to access the transaction details of a purchase.

>Request

GET http://api.trend-tech.net/MicroPayment/transaction/detail/{merchantId}/{serviceId}/{transactionId}

>Parameters

{merchantId}        Integer Merchant ID
{serviceId}         Integer Service ID.
{transactionId}     Integer Transaction ID of a payment processed on Payguru Platform. 

>Response

{  
    "response": {API_RESPONSE}   , 
    "subscription": {TRANSACTION_DETAIL} 
 }  

>Usage Limits

The total number of queries in aggregate on both client and server side can not exceed 1.000 queries per day. Similarly, the number of queries per second can not exceed 5.


2. Refund Transaction

It is the method enabling merchant to start a refund process for a transaction. It refunds a particular transaction with a particular transaction Id.

>Request

GET http://api.trend-tech.net/MicroPayment/transaction/refund/{merchantId}/{serviceId}/{transactionId}

>Parameters

{merchantId}        Integer Merchant ID
{serviceId}         Integer Service ID.
{transactionId}     Integer Transaction ID of a payment processed on Payguru Platform. 

>Response

{  
    "response": {API_RESPONSE}   ,
    "subscription": {TRANSACTION_SIMPLE_DETAIL}  
}

>Usage Limits

The total number of queries in aggregate on both client and server side can not exceed 20 queries per day. Similarly, the number of queries per second can not exceed 5.


3. Search Transactions

It is the service that enables the merchant to query Payguru Platform in order to access the transaction details of a group of transaction with a certain search criteria.

>Request

POST    http://api.trend-tech.net/MicroPayment/transactions/search

>Parameters

{  
"merchantId":{merchantId},
"serviceId":{serviceId},
"search":[{API_SEARCH_META}  , {API_SEARCH_META}  , {API_SEARCH_META} ],
"sort":[{API_SORT_META}  , {API_SORT_META}  , {API_SORT_META} ],
"limit":{limit}, 
"page":{page}
}

Parameter descriptions are shown below:

{merchantId}    Integer                 Merchat ID
{serviceId}     Integer                 Service ID.
{search}        {API_SEARCH_META}       Search Criteria on Searchable Columns in Payguru Platform, maximum 3.
{sort}          {API_SORT_META}         Sort Criteria, maximum 3. 
{limit}         Integer (Opsiyonel)     Number of records to be shown on each page (Default 10, maximum 100) 
{page}          Integer (Opsiyonel)     Number of page (Default 1)

>Response

{  

"response": {API_RESPONSE} , "meta": {COLLECTION_META_DATA} , "transactions":[ {TRANSACTION_SIMPLE_DETAIL} , {TRANSACTION_SIMPLE_DETAIL} , ... ] }

>Usage Limits

The total number of queries in aggregate on both client and server side can not exceed 1.000 queries per day. Similarly, the number of queries per second can not exceed 1.


4. Request Transaction

In theory, merchants have the capability to initiate the payment transactions on the Payguru platform. However, in accordance with the regulatory requirements and the Payguru risk management policies established within the framework of the payment license (license) granted by the BRSA, this service is not reachable and usable by the merchant.