---
title: "Fetch Sub-merchants Transactions"
method: POST
path: "/api/master-merchant/{mkey}/merchants/transactions"
tags: ["MasterMerchant APIs"]
---

# Fetch Sub-merchants Transactions

`POST /api/master-merchant/{mkey}/merchants/transactions`

## Request

- Base URL: `https://api.portone.cloud`
- URL: `https://api.portone.cloud/api/master-merchant/{mkey}/merchants/transactions`
- Auth: none declared

## Path parameters

- `mkey` string, required

## Headers

- `X-Portone-Client-Key` string
- `Authorization` string

## Request body

- object
  - `page` integer, required: The page number of the data to be fetched.
  - `pagesize` integer, required: The page size of the data to be fetched.
  - `from` string, required: The from Date to fetch the sub-merchant.
  - `to` string, required: The to Date to fetch the sub-merchant.
  - `merchant_keys` string[], required: The list of Sub-merchants PortOne keys
  - `environment` 'live' | 'sandbox', required: The environment of the transaction is either live OR sandbox

## Response `200`

Successful response

- object
  - `content` SubMerchantTransactionsContent[]
    - `currency` string: The currency of the transaction.
    - `amount` number, double: The amount of the transaction.
    - `order_ref` string: The unique order reference of the transaction generated by the PortOne.
    - `channel_order_ref` string: The unique order reference of the transaction generated by PSP.
    - `merchant_order_ref` string: The unique order reference of the transaction generated by the merchant.
    - `country_code` string: The correct country code for the transaction.
    - `status` string: The status of the transaction. Refer PortOne docs for additional details.
    - `channel_key` string: The unique Channel Key of the transaction. Refer PortOne docs for additional details.
    - `method_name` string: The unique Payment Method Key of the transaction. Refer PortOne docs for additional details.
    - `channel_logo` string: The PSP logo url.
    - `method_sub_type` string: The sub type of the Payment Method. Refer PortOne docs for additional details.
    - `buyer_name` string: The buyer name of the transaction.
    - `buyer_email` string: The buyer email of the transaction.
    - `buyer_phone` string: The buyer phone number of the transaction.
    - `buyer_address1` string: The buyer address of the transaction.
    - `buyer_address2` string: The buyer address of the transaction.
    - `buyer_city` string: The buyer city of the transaction.
    - `buyer_country` string: The country code of the buyer doing the transaction.
    - `signature_hash` string: The signature hash generated for the transaction details. Refer PortOne docs for additional details.
    - `status_code` string: The status code of the transaction.
    - `status_reason` string: The status reason of the transaction.
    - `status_channel_reason` string: The status channel reason of the transaction.
    - `date` string: The date timestamp of the transaction.
    - `is_refund_allowed` boolean: The boolean flag indicating whether refund is allowed for the transaction.
    - `is_multi_refund_allowed` boolean: The boolean flag indicating whether multple partial refunds are allowed for the transaction.
    - `refund_completed` boolean: The boolean flag indicating whether refunds is completed for the transaction.
    - `user_agent` string: The user_agent of the the device from which the transaction is created.
    - `ip_address` string: The IP address of the device from which the transaction is created.
    - `description` string: The description of the transaction.
    - `link_order_ref` string: The unique order reference of link.
    - `payment_link_ref` string: The unique order reference of payment link.
    - `source` string: The source of the transaction. API or checkout.
    - `payment_method_used` string: The actual payment method used for the transaction.
    - `merchant_name` string: The name of the merchant.
    - `merchant_key` string: The unique PortOne key of the merchant.
    - `merchant_email_address` string: The email_address of the merchant.
    - `recon_status` string: The status recon for the transaction.
    - `channel_name` string: The channel_name of the PSP used in transaction.
  - `total_elements` number: The number of total_elements in the response.
  - `total_pages` number: The number of total_pages in the response.
  - `size` number: The size of the current page.
  - `page` number: The current page number.
  - `number_of_elements` number: The number of elements in the current page.

## Other responses

- `400`: Failure response
- `401`: Failure response

---

[API](https://skmtc.dev/portone/apis/master-merchant-apis.md) - [All operations](https://skmtc.dev/portone/apis/master-merchant-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/portone/apis/master-merchant-apis/revisions/bc3593c8539c?raw)