Skip to main content
GET
/
merchant
/
transactions
Get Transactions
curl --request GET \
  --url https://testapi.fractalpay.com/api/v1/merchant/transactions \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_date": "2024-01-15",
  "limit": "20",
  "merchant_key": "{{merchant_key}}",
  "pageNumber": 0,
  "to_date": "2024-07-18"
}
'
import requests

url = "https://testapi.fractalpay.com/api/v1/merchant/transactions"

payload = {
    "from_date": "2024-01-15",
    "limit": "20",
    "merchant_key": "{{merchant_key}}",
    "pageNumber": 0,
    "to_date": "2024-07-18"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'GET',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    from_date: '2024-01-15',
    limit: '20',
    merchant_key: '{{merchant_key}}',
    pageNumber: 0,
    to_date: '2024-07-18'
  })
};

fetch('https://testapi.fractalpay.com/api/v1/merchant/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://testapi.fractalpay.com/api/v1/merchant/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'from_date' => '2024-01-15',
    'limit' => '20',
    'merchant_key' => '{{merchant_key}}',
    'pageNumber' => 0,
    'to_date' => '2024-07-18'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://testapi.fractalpay.com/api/v1/merchant/transactions"

	payload := strings.NewReader("{\n  \"from_date\": \"2024-01-15\",\n  \"limit\": \"20\",\n  \"merchant_key\": \"{{merchant_key}}\",\n  \"pageNumber\": 0,\n  \"to_date\": \"2024-07-18\"\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://testapi.fractalpay.com/api/v1/merchant/transactions")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_date\": \"2024-01-15\",\n  \"limit\": \"20\",\n  \"merchant_key\": \"{{merchant_key}}\",\n  \"pageNumber\": 0,\n  \"to_date\": \"2024-07-18\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://testapi.fractalpay.com/api/v1/merchant/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_date\": \"2024-01-15\",\n  \"limit\": \"20\",\n  \"merchant_key\": \"{{merchant_key}}\",\n  \"pageNumber\": 0,\n  \"to_date\": \"2024-07-18\"\n}"

response = http.request(request)
puts response.read_body
{
  "data": [
    {
      "amount": "1.00",
      "created_date": "2024-07-15T22:47:06.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "y1sskla5N",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_294ac4cb42"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T22:45:44.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "9nYTCO3",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_f83920db42"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T22:45:27.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "ZZ072OJeLk",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_ee8a4828"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T22:45:14.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "IEWrahzKAB",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_e6bbd59542"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T22:43:48.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "jPXI7gxQ",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_b330e46b42"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T16:32:20.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "ZvaoUl4Lyq",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_cec8b3b142"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T16:29:25.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "i6a7il0",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_664f064a42"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T16:19:33.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "0N1BuUwq",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_057629e642"
    },
    {
      "amount": "1.00",
      "created_date": "2024-07-15T16:18:46.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 0.97,
      "other_details": {
        "auth_code": "k7NiHFSOQF",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_e95bd20742"
    },
    {
      "amount": "4.55",
      "created_date": "2024-07-11T16:13:29.000Z",
      "fee_percentage": "0.1365000",
      "net_amount": 4.41,
      "other_details": {
        "auth_code": "8eD7NXQ0",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_82b654dc3f"
    },
    {
      "amount": "8.00",
      "created_date": "2024-07-09T17:59:34.000Z",
      "fee_percentage": "0.2400000",
      "net_amount": 7.76,
      "other_details": {
        "auth_code": "M2bxfXS",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_ffd2c8343e"
    },
    {
      "amount": "3.00",
      "created_date": "2024-07-09T15:57:10.000Z",
      "fee_percentage": "0.0900000",
      "net_amount": 2.91,
      "other_details": {
        "auth_code": "WxxkG24J",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_e656c18b3e"
    },
    {
      "amount": "4.00",
      "created_date": "2024-07-09T15:54:40.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 4,
      "other_details": {
        "auth_code": "7caxq68qT",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_8d1d35a93e"
    },
    {
      "amount": "7.00",
      "created_date": "2024-07-09T15:28:51.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 7,
      "other_details": {
        "auth_code": "zGlAoC3Zk",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_f1e946cc3e"
    },
    {
      "amount": "6.00",
      "created_date": "2024-07-08T17:13:52.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 2.82,
      "other_details": {
        "auth_code": "cTbiOd2dwY",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_72ea4c0e3d"
    },
    {
      "amount": "2.00",
      "created_date": "2024-07-08T17:09:17.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": -1.06,
      "other_details": {
        "auth_code": "C1AQg5S",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_cf54dd133d"
    },
    {
      "amount": "3.00",
      "created_date": "2024-07-08T16:12:32.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 2.91,
      "other_details": {
        "auth_code": "00tCCRUMEB",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_e1d611ae3d"
    },
    {
      "amount": "8.00",
      "created_date": "2024-07-08T16:07:16.000Z",
      "fee_percentage": "0.0000000",
      "net_amount": 7.76,
      "other_details": {
        "auth_code": "M5a0IKoB",
        "card_brand": "VISA",
        "last_four": "0043"
      },
      "transaction_id": "txn_2582623a3d"
    }
  ],
  "message": "Merchant's Transactions",
  "result": true,
  "total": 18
}

Authorizations

Authorization
string
header
required

Use your Fractal API credentials.

Username = Client ID Password = Secret Key

Sandbox credentials can be generated from the Test Portal.

Body

application/json
merchant_key
string
required

The merchant's unique key. Returned in the merchant_key field of the get merchants by client call.

Example:

"{{merchant_key}}"

from_date
string
Example:

"2024-01-15"

limit
string
Example:

"20"

pageNumber
number
Example:

0

to_date
string
Example:

"2024-07-18"

Response

200 - application/json

Get Transactions

data
object[]
Example:
[
  {
    "amount": "1.00",
    "created_date": "2024-07-15T22:47:06.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "y1sskla5N",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_294ac4cb42"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T22:45:44.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "9nYTCO3",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_f83920db42"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T22:45:27.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "ZZ072OJeLk",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_ee8a4828"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T22:45:14.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "IEWrahzKAB",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_e6bbd59542"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T22:43:48.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "jPXI7gxQ",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_b330e46b42"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T16:32:20.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "ZvaoUl4Lyq",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_cec8b3b142"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T16:29:25.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "i6a7il0",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_664f064a42"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T16:19:33.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "0N1BuUwq",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_057629e642"
  },
  {
    "amount": "1.00",
    "created_date": "2024-07-15T16:18:46.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 0.97,
    "other_details": {
      "auth_code": "k7NiHFSOQF",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_e95bd20742"
  },
  {
    "amount": "4.55",
    "created_date": "2024-07-11T16:13:29.000Z",
    "fee_percentage": "0.1365000",
    "net_amount": 4.41,
    "other_details": {
      "auth_code": "8eD7NXQ0",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_82b654dc3f"
  },
  {
    "amount": "8.00",
    "created_date": "2024-07-09T17:59:34.000Z",
    "fee_percentage": "0.2400000",
    "net_amount": 7.76,
    "other_details": {
      "auth_code": "M2bxfXS",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_ffd2c8343e"
  },
  {
    "amount": "3.00",
    "created_date": "2024-07-09T15:57:10.000Z",
    "fee_percentage": "0.0900000",
    "net_amount": 2.91,
    "other_details": {
      "auth_code": "WxxkG24J",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_e656c18b3e"
  },
  {
    "amount": "4.00",
    "created_date": "2024-07-09T15:54:40.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 4,
    "other_details": {
      "auth_code": "7caxq68qT",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_8d1d35a93e"
  },
  {
    "amount": "7.00",
    "created_date": "2024-07-09T15:28:51.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 7,
    "other_details": {
      "auth_code": "zGlAoC3Zk",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_f1e946cc3e"
  },
  {
    "amount": "6.00",
    "created_date": "2024-07-08T17:13:52.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 2.82,
    "other_details": {
      "auth_code": "cTbiOd2dwY",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_72ea4c0e3d"
  },
  {
    "amount": "2.00",
    "created_date": "2024-07-08T17:09:17.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": -1.06,
    "other_details": {
      "auth_code": "C1AQg5S",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_cf54dd133d"
  },
  {
    "amount": "3.00",
    "created_date": "2024-07-08T16:12:32.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 2.91,
    "other_details": {
      "auth_code": "00tCCRUMEB",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_e1d611ae3d"
  },
  {
    "amount": "8.00",
    "created_date": "2024-07-08T16:07:16.000Z",
    "fee_percentage": "0.0000000",
    "net_amount": 7.76,
    "other_details": {
      "auth_code": "M5a0IKoB",
      "card_brand": "VISA",
      "last_four": "0043"
    },
    "transaction_id": "txn_2582623a3d"
  }
]
message
string
Example:

"Merchant's Transactions"

result
boolean
Example:

true

total
number
Example:

18