Card Transactions

List card transactions

curl --request GET \
  --url https://api.fyatu.com/api/v3.20/cards/{id}/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3.20/cards/{id}/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://api.fyatu.com/api/v3.20/cards/{id}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.fyatu.com/api/v3.20/cards/{id}/transactions"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3.20/cards/{id}/transactions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": 200,
  "message": "Card transactions retrieved",
  "data": [
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0001",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "SETTLED",
      "amount": 12.5,
      "feeAmount": 0,
      "currency": "USD",
      "merchant": {
        "name": "STARBUCKS #1234",
        "id": "MER_STARBUCKS_001",
        "city": "San Francisco",
        "country": "US",
        "mcc": "5812",
        "mccCategory": "Eating Places, Restaurants"
      },
      "memo": "STARBUCKS #1234",
      "isSettled": true,
      "wasReversed": false,
      "createdAt": "2026-05-25T14:32:00Z"
    },
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0002",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "DECLINED",
      "amount": 250,
      "feeAmount": 0,
      "currency": "USD",
      "merchant": {
        "name": "AMAZON.COM",
        "id": "MER_AMAZON_001",
        "city": "Seattle",
        "country": "US",
        "mcc": "5999",
        "mccCategory": "Miscellaneous Retail Stores"
      },
      "memo": "AMAZON.COM",
      "isSettled": false,
      "wasReversed": false,
      "createdAt": "2026-05-24T09:10:00Z"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}

GET

cards

{id}

transactions

List card transactions

curl --request GET \
  --url https://api.fyatu.com/api/v3.20/cards/{id}/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3.20/cards/{id}/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://api.fyatu.com/api/v3.20/cards/{id}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.fyatu.com/api/v3.20/cards/{id}/transactions"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3.20/cards/{id}/transactions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": 200,
  "message": "Card transactions retrieved",
  "data": [
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0001",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "SETTLED",
      "amount": 12.5,
      "feeAmount": 0,
      "currency": "USD",
      "merchant": {
        "name": "STARBUCKS #1234",
        "id": "MER_STARBUCKS_001",
        "city": "San Francisco",
        "country": "US",
        "mcc": "5812",
        "mccCategory": "Eating Places, Restaurants"
      },
      "memo": "STARBUCKS #1234",
      "isSettled": true,
      "wasReversed": false,
      "createdAt": "2026-05-25T14:32:00Z"
    },
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0002",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "DECLINED",
      "amount": 250,
      "feeAmount": 0,
      "currency": "USD",
      "merchant": {
        "name": "AMAZON.COM",
        "id": "MER_AMAZON_001",
        "city": "Seattle",
        "country": "US",
        "mcc": "5999",
        "mccCategory": "Miscellaneous Retail Stores"
      },
      "memo": "AMAZON.COM",
      "isSettled": false,
      "wasReversed": false,
      "createdAt": "2026-05-24T09:10:00Z"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}

Overview

Returns a paginated list of card-level transactions sourced directly from the card network. This includes purchases, declines, refunds, reversals, and fees — everything that moved money on the physical card.

These are card-to-merchant transactions, not program ledger movements. For deposits, withdrawals, and card funding/unload events, use GET /transactions instead.

Path Parameters

Parameter	Type	Description
`id`	string	The card ID (prefix `crd_`)

Query Parameters

Parameter	Type	Default	Description
`page`	integer	`1`	Page number (1-based)
`limit`	integer	`20`	Results per page (max: 100)

Transaction Object

Field	Type	Description
`transactionId`	string	Unique transaction identifier from the card network
`cardId`	string	The card ID this transaction belongs to
`type`	string	Transaction type (e.g. `PURCHASE`, `REFUND`, `FEE`)
`status`	string	`SETTLED`, `PENDING`, `DECLINED`, `REVERSED`
`amount`	number	Transaction amount in card currency
`feeAmount`	number	Network fee charged (if any)
`currency`	string	Transaction currency (e.g. `USD`)
`merchant`	object	Merchant details — present for purchase transactions
`merchant.name`	string	Merchant name
`merchant.id`	string	Merchant ID at the network
`merchant.city`	string	Merchant city
`merchant.country`	string	Merchant country code
`merchant.mcc`	string	Merchant Category Code
`merchant.mccCategory`	string	Human-readable MCC description
`memo`	string	Transaction memo or description
`isSettled`	boolean	Whether the transaction has cleared
`wasReversed`	boolean	Whether the transaction was reversed
`createdAt`	string	Transaction timestamp (ISO 8601)
`references`	object	Network identifiers for tracing the payment — see References

References

references carries the identifiers a merchant, a cardholder’s bank or our support team needs to trace a card payment — for example when a cardholder asks a merchant for a refund. It is always present; funding and unloads carry no network identifiers, so for them it is an empty object. Each field appears only when the card network supplied it.

Field	Type	Description
`references.authorizationCode`	string	Authorization identifier issued when the payment was approved
`references.rrn`	string	Retrieval Reference Number assigned by the card network (12 digits)
`references.arn`	string	Acquirer Reference Number — see the note below
`references.merchantId`	string	Merchant identifier at the network
`references.network`	string	Card network, e.g. `MASTERCARD`
`references.maskedPan`	string	Masked card number the payment was made with
`references.authorizationAmount`	number	Amount the merchant requested, in the merchant’s currency. Differs from `amount` on foreign-currency payments
`references.authorizationCurrency`	string	Currency of `authorizationAmount`
`references.relatedTransactionId`	string	On a fee (cross-border, decline fee): the `transactionId` it was charged on

The ARN is assigned by the merchant’s acquirer when it submits the payment for clearing, so an authorization that has not cleared never has one. When arn is absent on a cleared payment, contact support with the rrn and authorizationCode and we will obtain it. A refund request to the merchant does not need the ARN — the merchant identifies the payment from its own order.

Example

curl https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/transactions \
  -H "Authorization: Bearer $FYATU_API_KEY"

const resp = await fetch(
  'https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/transactions?page=1&limit=20',
  { headers: { 'Authorization': `Bearer ${process.env.FYATU_API_KEY}` } }
);
const body = await resp.json();
body.data.forEach(txn => {
  console.log(`${txn.merchant?.name ?? txn.memo}: $${txn.amount} (${txn.status})`);
});

import os, requests

resp = requests.get(
    'https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/transactions',
    params={'page': 1, 'limit': 20},
    headers={'Authorization': f'Bearer {os.environ["FYATU_API_KEY"]}'}
)
for txn in resp.json()['data']:
    merchant = txn.get('merchant', {})
    print(f"{merchant.get('name', txn['memo'])}: ${txn['amount']} ({txn['status']})")

Success Response (200)

{
  "success": true,
  "status": 200,
  "message": "Card transactions retrieved",
  "data": [
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0001",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "SETTLED",
      "amount": 12.50,
      "feeAmount": 0.00,
      "currency": "USD",
      "merchant": {
        "name": "STARBUCKS #1234",
        "id": "MER_STARBUCKS_001",
        "city": "San Francisco",
        "country": "US",
        "mcc": "5812",
        "mccCategory": "Eating Places, Restaurants"
      },
      "memo": "STARBUCKS #1234",
      "isSettled": true,
      "wasReversed": false,
      "createdAt": "2026-05-25T14:32:00Z",
      "references": {
        "authorizationCode": "0eaf73d7-ee43-4fc1-9f5b-dabcf2044259",
        "rrn": "623015440030",
        "merchantId": "MER_STARBUCKS_001",
        "network": "MASTERCARD",
        "maskedPan": "XXXXXXXXXXXX1111",
        "authorizationAmount": 12.50,
        "authorizationCurrency": "USD"
      }
    },
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0002",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "DECLINED",
      "amount": 250.00,
      "feeAmount": 0.00,
      "currency": "USD",
      "merchant": {
        "name": "AMAZON.COM",
        "id": "MER_AMAZON_001",
        "city": "Seattle",
        "country": "US",
        "mcc": "5999",
        "mccCategory": "Miscellaneous Retail Stores"
      },
      "memo": "AMAZON.COM",
      "isSettled": false,
      "wasReversed": false,
      "createdAt": "2026-05-24T09:10:00Z",
      "references": {
        "authorizationCode": "27b8aacf-2576-418c-8c15-22a9f18ab85f",
        "rrn": "091217827592",
        "merchantId": "MER_AMAZON_001",
        "network": "MASTERCARD",
        "maskedPan": "XXXXXXXXXXXX1111",
        "authorizationAmount": 250.00,
        "authorizationCurrency": "USD"
      }
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}

If the card has not yet been fully provisioned by the card network, the data array will be empty and pagination.total will be 0.

Error Codes

Code	HTTP	Cause
`CARD_NOT_FOUND`	404	Card does not exist or belongs to another business/environment
`PROVIDER_ERROR`	500	Card network unavailable — retry with exponential back-off
`INSUFFICIENT_SCOPE`	403	Key lacks `cards:read` scope

Authorizations

Authorization

string

header

required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Path Parameters

string

required

Query Parameters

page

integer

default:1

Page number (1-based)

Required range: x >= 1

limit

integer

default:20

Results per page

Required range: 1 <= x <= 100

Response

Card transactions retrieved

success

boolean

status

integer

message

string

data

object[]

Show child attributes

pagination

object

Show child attributes

Account

Products

Cardholders

Cards

Webhooks

Overview

Path Parameters

Query Parameters

Transaction Object

References

Example

Success Response (200)

Error Codes

Authorizations

Path Parameters

Query Parameters

Response

​Overview

​Path Parameters

​Query Parameters

​Transaction Object

​References

​Example

​Success Response (200)

​Error Codes

Authorizations

Path Parameters

Query Parameters

Response

Overview

Path Parameters

Query Parameters

Transaction Object

References

Example

Success Response (200)

Error Codes