MarasoftPay Documentation

Payout History

Learn how to check the account history of your transfers https://api.marasoftpay.live/account_history/transfers API

1. Post Data to API

To begin, you'll need to pass information such as Encryption Key, Start Date, End Date etc. You can also pass any other additional information in the metadata object field and post in the json format below.

Make a POST request to https://api.marasoftpay.live/account_history/transfers from your server using your transaction reference.

Usage

API Endpoint - https://api.marasoftpay.live/account_history/transfers

Method - POST

Data Type - FORM-DATA

Limit - No Limit

Postman - https://documenter.getpostman.com/payout_history

Param	Required?	Description
enc_key	yes	Your encryption Key
start_date	yes	Start Date in format d-m-y
end_date	yes	End Date in format d-m-y

Code example


                                
                                    <?php

    $curl = curl_init();
    curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://api.marasoftpay.live/account_history/transfers',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS => array('enc_key' => 'your encryption key', 'start_date' => '06-03-2023', 'end_date' => '22-03-2023'),
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;

?>


                                
                                    var axios = require('axios');
var FormData = require('form-data');
var data = new FormData();
data.append('enc_key', 'your encryption key');
data.append('start_date', '06-03-2023');
data.append('end_date', '22-03-2023');
var config = {
  method: 'post',
  url: 'https://api.marasoftpay.live/account_history/transfers',
  headers: { 
    ...data.getHeaders()
  },
  data : data
};
axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});


                                
                                    import requests
url = "https://api.marasoftpay.live/account_history/transfers"
payload={'enc_key': 'your encryption key',
'start_date': '06-03-2023',
'end_date': '22-03-2023'}
files=[
]
headers = {}
response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.text)

2. Url Response

Below is what your response should look like.


                            
                                {
    "request_status": true,
    "transactions": [
        {
            "transaction_ref": "ref_789MPWR43627389",
            "msft_reference": "TRA_21258021178182",
            "beneficiary_account_number": "078563421",
            "beneficiary_account_name": "OLUWAFERANMI DAVID MARAYESA",
            "beneficiary_bank_code": "044",
            "currency": "KSH",
            "amount": "10000",
            "transaction_status": "SUCCESS",
            "created_at": "2023-Mar-06 12: 48: 01 AM"
        },
        {
            "transaction_ref": "ref_789MPWR43627389",
            "msft_reference": "TRA_21258021178182",
            "beneficiary_account_number": "078563421",
            "beneficiary_account_name": "OLUWAFERANMI DAVID MARAYESA",
            "beneficiary_bank_code": "044",
            "currency": "KSH",
            "amount": "200",
            "transaction_status": "FAILED",
            "created_at": "2023-Mar-06 12: 48: 01 AM"
        }


        {
            "transaction_ref": "ref_789MPWR43627389",
            "msft_reference": "TRA_21258021178182",
            "beneficiary_account_number": "078563421",
            "beneficiary_account_name": "OLUWAFERANMI DAVID MARAYESA",
            "beneficiary_bank_code": "044",
            "currency": "KSH",
            "amount": "1000",
            "transaction_status": "SUCCESS",
            "created_at": "2023-Mar-06 12: 48: 01 AM"
        }
    ]
}

3. Error Response

Below is what an error response should look like.


                            
                                {
    "request_status": false,
    "error": "start_date cannot be greater than end_date",
}