Skip to main content
interface Transaction {
  id: number;                      // internal numeric ID
  transaction_id: string;          // UUID
  transaction_amount: string;
  transaction_status: TransactionStatus;
  transaction_type: TransactionType;
  transaction_currency: string;
  transaction_memo: string;
  transaction_purpose: string;
  customer_id: string | null;
  created_at: string;
}

type TransactionStatus =
  | "success"
  | "complete"
  | "detected"
  | "pending"
  | "In Progress"
  | "failed";

type TransactionType =
  | "deposit"
  | "payout"
  | "virtual_account"
  | "transfer"
  | "card_transaction"
  | "crypto_deposit";

​
List transactions

GET /business/transactions/index
All query parameters are optional and can be combined.
​
status
string
Filter by status: success, complete, detected, pending, In Progress, failed.
​
transaction_type
string
Filter by type: deposit, payout, virtual_account, transfer, card_transaction, crypto_deposit.
​
customer_id
string
Filter by customer ID.
​
amount
number
Filter by exact transaction amount.
​
start_date
string
From date (inclusive), e.g. 2026-03-01.
​
end_date
string
To date (inclusive), e.g. 2026-03-31.
​
page
number
Page number. Default: 1.
​
per_page
number
Results per page. Default: 10.
curl -X GET 'https://api.yativo.com/api/v1/business/transactions/index?status=success&transaction_type=deposit&start_date=2026-03-01&end_date=2026-03-31&page=1&per_page=10' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "status_code": 200,
  "message": "Records retrieved successfully",
  "data": [
    {
      "id": 14,
      "transaction_id": "a0e9e50e-81be-4bd0-9941-0151e68b9e97",
      "transaction_amount": "8.736",
      "transaction_status": "success",
      "transaction_type": "deposit",
      "transaction_memo": "payin",
      "transaction_purpose": "Deposit",
      "transaction_currency": "BRL",
      "customer_id": null,
      "created_at": "2026-03-15T10:00:00.000000Z"
    }
  ],
  "meta": {
    "total": 6,
    "per_page": 10,
    "current_page": 1,
    "last_page": 1,
    "next_page_url": null,
    "prev_page_url": null
  }
}

​
Get transaction

GET /business/transaction/show/{id}
​
id
number
required
The internal numeric transaction ID (the id field, not transaction_id).
curl -X GET 'https://api.yativo.com/api/v1/business/transaction/show/14' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
The single transaction response includes additional payin_method and payout_method objects with payment method details.

​
Track transaction

Get a live status timeline for a transaction. 
GET /transaction/tracking/{transaction_id}
​
transaction_id
string
required
The transaction UUID (transaction_id field).
curl -X GET 'https://api.yativo.com/api/v1/transaction/tracking/a0e9e50e-81be-4bd0-9941-0151e68b9e97' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": [
    {
      "tracking_status": "Payment credited to beneficiary",
      "transaction_type": "withdrawal",
      "created_at": "2026-03-15T10:03:22.000000Z"
    },
    {
      "tracking_status": "With Beneficiary's Bank/Rail",
      "transaction_type": "withdrawal",
      "created_at": "2026-03-15T10:02:54.000000Z"
    },
    {
      "tracking_status": "Processed by Yativo",
      "transaction_type": "withdrawal",
      "created_at": "2026-03-15T10:01:45.000000Z"
    },
    {
      "tracking_status": "Send money initiated",
      "transaction_type": "withdrawal",
      "created_at": "2026-03-15T10:00:00.000000Z"
    }
  ]
}

​
Transaction metadata

GET /transaction/metadata/{transaction_id}
​
transaction_id
string
required
The transaction UUID.

​
Transactions by currency

GET /business/transaction/by-currency?currency={code}
​
currency
string
required
Currency code (e.g. BRL, USD, CLP).
curl -X GET 'https://api.yativo.com/api/v1/business/transaction/by-currency?currency=BRL' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Download receipt (PDF)

Download a receipt for a completed transaction. Returns a base64-encoded PDF. 
GET /business/transaction/{transaction_id}/pdf/receipt
​
transaction_id
string
required
The transaction UUID.
curl -X GET 'https://api.yativo.com/api/v1/business/transaction/a0e9e50e-81be-4bd0-9941-0151e68b9e97/pdf/receipt' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'