Skip to main content
GET
/
merchant
/
api
/
v1
/
transactions
Get merchant transaction history
curl --request GET \
  --url http://api-sandbox.fexpayments.com/merchant/api/v1/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "merchant_id": "74815c83-e47b-4dc5-aefe-abe4484dd280",
  "transactions": [
    {
      "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
      "transaction_type": "payment",
      "status": "completed",
      "amount": "49.99",
      "currency": "USD",
      "from_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "Payment to Whole Foods Market",
      "metadata": {
        "payment_intent_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 47,
  "total_pages": 3
}

Authorizations

​
Authorization
string
header
required

Keycloak JWT. Roles: admin (platform admin — can register merchants, act on behalf of any merchant), merchant (dashboard user — scoped to their own merchant_id via user attribute mapper), POS terminals use client credentials flow with merchant_id injected via protocol mapper.

Query Parameters

​
page
integer
default:1

Page number (default: 1)

Required range: x >= 1
​
limit
integer
default:20

Items per page (default: 20, max: 100)

Required range: 1 <= x <= 100

Response

Paginated transaction list

​
success
boolean
Example:

true

​
merchant_id
string<uuid>
Example:

"74815c83-e47b-4dc5-aefe-abe4484dd280"

​
transactions
object[]
​
page
integer
Example:

1

​
limit
integer
Example:

20

​
total
integer
Example:

47

​
total_pages
integer
Example:

3