List Transactions for Payment

GET /payments/{id}/transactions

Try it

Parameters

Idempotency-KeyheaderX-Correlation-IDheaderlimitqueryoffsetqueryfromDate*querytoDate*queryid*path

Request sampleLanguage

curl -X GET 'https://one.ozow.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions?limit=50&offset=0&fromDate=2026-01-15&toDate=2026-01-31' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Idempotency-Key: string' \
  -H 'X-Correlation-ID: 00000000-0000-0000-0000-000000000000'

Response exampleStatus

{
  "links": {
    "self": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=50",
    "first": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=0",
    "last": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=100",
    "prev": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=0",
    "next": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=100"
  },
  "results": [
    {
      "links": {
        "self": "https://one.ozow.com/v1/transactions/497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "refund": "https://one.ozow.com/v1/transactions/497f6eca-6276-4993-bfeb-53cbbbba6f08/refunds"
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "amount": {
        "currency": "ZAR",
        "value": 50
      },
      "merchantReference": "12345-abcde",
      "siteCode": "SITE-001",
      "institution": "First National Bank",
      "status": "Incomplete",
      "reason": "<reason>",
      "createdDate": "2026-01-15T09:30:00Z",
      "completedDate": "2026-01-15T09:32:47Z"
    }
  ],
  "meta": {
    "totalPages": 1,
    "totalItems": 1
  }
}

Built from the response schema. Values are placeholders, not real data.

GEThttps://one.ozow.com/v1/payments/{id}/transactionsProduction

Build with AI 2 packages

A build package is every page for one task, with the API operations they use. Copy the prompt into a coding assistant, or hand it the package itself: slim links to each page, full inlines all of them in one document.

Take a paymentEverything needed to take a payment end to end with One API, from credentials through the hosted page to the webhook that confirms it, and the test cases that prove each outcome before you go live.
View package
Migrate a payin from the Payments API to One APIEverything needed to move an existing redirect payin onto One API, with the legacy guide and its One API counterpart side by side.
View package

List the transactions associated with the payment request with the specified id. An id matching no payment answers 200 with an empty result list rather than 404, so check whether a transaction came back rather than reading the status code.

Authentication

OAuth 2.0
scopespayments

Path parameters

id string required
The unique identifier of the payment.
example497f6eca-6276-4993-bfeb-53cbbbba6f08

Query parameters

limit integer
The maximum number of items to return.
min1max50default50
offset integer
The number of items to discard in this paging operation.
min length0min0default0
fromDate string required
The date from which to filter, inclusive. Whole days only, so any time sent with it is discarded.
example2026-01-15
toDate string required
The date to filter up to, inclusive. Whole days only, so any time sent with it is discarded.
example2026-01-31

Header parameters

Idempotency-Key string
The unique key idempotency key as per the following IETF Draft
X-Correlation-ID string
Optional correlation id for the request, if not supplied a new one will be generated and passed onto all underlying requests and returned as a header.

Responses

200 OK.

X-Correlation-ID header
The correlation id for the request that was processed.

links PaginationLinks
Standard JSON API pagination links. Each link repeats the query that produced the collection and carries its own limit and offset. Follow the link rather than building the next URI. The example below is the second of three pages.
Fields of PaginationLinks
- self string uri
  The current page of data.
- first string uri
  The first page of data.
- last string uri nullable
  The last page of data. Null when the whole collection fits on one page.
- prev string uri nullable
  The previous page of data. Null on the first page.
- next string uri nullable
  The next page of data. Null on the last page.
Open PaginationLinks on its own page
results array of Transaction
Fields of Transaction
- links TransactionLinks
  Fields of TransactionLinks
  self string uri required
  The unique URI for this resource.
  refund string uri
  The refund operation for this transaction. This is a POST operation.
  Open TransactionLinks on its own page
- id string uuid required
  The transaction id of the payment.
- amount Amount
  The amount that was requested.
  Fields of Amount
  currency string required
  The ISO 4217 current code.
  min length3max length3
  value number float required
  The amount in the currency specified.
  min0.01
  Open Amount on its own page
- merchantReference string required
  The merchant's reference for the transaction.
  max length50
- siteCode string required
  The merchant site code in use for this payment.
  max length50
- institution string required
  The institution for the transaction.
- status TransactionStatus required
  The status of the transaction.
  values"Incomplete""Successful""Error""Pending""Refunded"
- reason string
  Payment status reason.
- createdDate string date-time required
  The date the transaction was created.
- completedDate string date-time
  The date the transaction was completed.
Open Transaction on its own page
meta PaginationMeta
Fields of PaginationMeta
- totalPages integer required
  The total number of pages available.
- totalItems integer required
  The total number of items available.
Open PaginationMeta on its own page

500 Internal Server Error.

X-Correlation-ID header
The correlation id for the request that was processed.

id string uuid required
a unique identifier for this particular occurrence of the problem.
links object nullable
Present on an authentication or authorisation failure, and null otherwise.
- about string uri
  A link that leads to further details about this particular occurrence of the problem. When derefenced, this URI SHOULD return a human-readable description of the error.
- type string uri
  A link that identifies the type of error that this particular error is an instance of. This URI SHOULD be dereferencable to a human-readable explanation of the general error.
code string required
An application-specific error code, expressed as a string value. Key on this rather than on title or detail, which are written for a person. A rejection at the transport level uses the status name, one of BadRequest, Unauthorized, Forbidden, NotFound, NotAllowed, Conflict, UnsupportedMediaType, BadGateway or InternalServerError. An operation refusing a request on its own rules returns a code of its own.
title string required
A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
detail string required
A human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.
source object nullable
Where in the request the problem was found. All three keys are present whenever source is, with the ones that do not apply set to null. source itself is null where the failure is not about a part of the request.
- pointer string json-pointer nullable
  a JSON Pointer RFC6901 to the value in the request document that caused the error [e.g. "/data" for a primary data object, or "/data/attributes/title" for a specific attribute]. This MUST point to a value in the request document that exists; if it doesn’t, the client SHOULD simply ignore the pointer.
- parameter string nullable
  A string indicating which URI query parameter caused the error.
- header string nullable
  A string indicating the name of a single request header which caused the error.
meta object nullable
A meta object containing non-standard meta-information about the error. Null where the request carried no X-Correlation-ID, and on an authentication failure, which does not echo it.
- correlationId string
  The X-Correlation-ID sent with the request, echoed back so it can be quoted to support. Absent when the request carried no correlation header.

The request failed on the Ozow side

{
  "id": "9e0d5a83-6b24-4c19-8f7a-2d1b3e6c0a97",
  "links": null,
  "code": "InternalServerError",
  "title": "Internal Server Error",
  "detail": "Error occurred while processing request.",
  "source": {
    "pointer": "/data",
    "parameter": null,
    "header": null
  },
  "meta": {
    "correlationId": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  }
}

Guides

Request

curl -X GET 'https://one.ozow.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions?limit=50&offset=0&fromDate=2026-01-15&toDate=2026-01-31' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Idempotency-Key: string' \
  -H 'X-Correlation-ID: 00000000-0000-0000-0000-000000000000'

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://one.ozow.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions?limit=50&offset=0&fromDate=2026-01-15&toDate=2026-01-31");
request.Headers.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN");
request.Headers.Add("Idempotency-Key", "string");
request.Headers.Add("X-Correlation-ID", "00000000-0000-0000-0000-000000000000");

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://one.ozow.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions?limit=50&offset=0&fromDate=2026-01-15&toDate=2026-01-31',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_ACCESS_TOKEN',
        'Idempotency-Key: string',
        'X-Correlation-ID: 00000000-0000-0000-0000-000000000000',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

const response = await fetch("https://one.ozow.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions?limit=50&offset=0&fromDate=2026-01-15&toDate=2026-01-31", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Idempotency-Key": "string",
    "X-Correlation-ID": "00000000-0000-0000-0000-000000000000",
  },
});

const data = await response.json();

import requests

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Idempotency-Key": "string",
    "X-Correlation-ID": "00000000-0000-0000-0000-000000000000",
}

response = requests.get(
    "https://one.ozow.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions?limit=50&offset=0&fromDate=2026-01-15&toDate=2026-01-31",
    headers=headers,
)

Response

OK.

{
  "links": {
    "self": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=50",
    "first": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=0",
    "last": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=100",
    "prev": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=0",
    "next": "https://one.ozow.com/v1/payments?siteCode=SITE-001&fromDate=2026-01-01&toDate=2026-01-31&limit=50&offset=100"
  },
  "results": [
    {
      "links": {
        "self": "https://one.ozow.com/v1/transactions/497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "refund": "https://one.ozow.com/v1/transactions/497f6eca-6276-4993-bfeb-53cbbbba6f08/refunds"
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "amount": {
        "currency": "ZAR",
        "value": 50
      },
      "merchantReference": "12345-abcde",
      "siteCode": "SITE-001",
      "institution": "First National Bank",
      "status": "Incomplete",
      "reason": "<reason>",
      "createdDate": "2026-01-15T09:30:00Z",
      "completedDate": "2026-01-15T09:32:47Z"
    }
  ],
  "meta": {
    "totalPages": 1,
    "totalItems": 1
  }
}

Built from the response schema. Values are placeholders, not real data.

Bad Request

{
  "id": "00000000-0000-0000-0000-000000000000",
  "links": {
    "about": "https://example.com/about",
    "type": "https://example.com/type"
  },
  "code": "Unauthorized",
  "title": "Unauthorized Request",
  "detail": "Authorization header is missing or invalid.",
  "source": {
    "pointer": "/data",
    "parameter": "id",
    "header": "Authorization"
  },
  "meta": {
    "correlationId": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  }
}

Built from the response schema. Values are placeholders, not real data.

Unauthorized

{
  "id": "00000000-0000-0000-0000-000000000000",
  "links": {
    "about": "https://example.com/about",
    "type": "https://example.com/type"
  },
  "code": "Unauthorized",
  "title": "Unauthorized Request",
  "detail": "Authorization header is missing or invalid.",
  "source": {
    "pointer": "/data",
    "parameter": "id",
    "header": "Authorization"
  },
  "meta": {
    "correlationId": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  }
}

Built from the response schema. Values are placeholders, not real data.

Internal Server Error.

{
  "id": "9e0d5a83-6b24-4c19-8f7a-2d1b3e6c0a97",
  "links": null,
  "code": "InternalServerError",
  "title": "Internal Server Error",
  "detail": "Error occurred while processing request.",
  "source": {
    "pointer": "/data",
    "parameter": null,
    "header": null
  },
  "meta": {
    "correlationId": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  }
}