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

Retrieve all transactions for your business with optional filters: 
GET /business/transactions/index
​
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-04-01.
​
end_date
string
To date (inclusive), e.g. 2026-04-30.
​
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-04-01&end_date=2026-04-30&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": "1000.00",
      "transaction_status": "success",
      "transaction_type": "deposit",
      "transaction_memo": "payin",
      "transaction_purpose": "Deposit",
      "transaction_currency": "BRL",
      "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
      "created_at": "2026-04-01T10:00:00.000000Z"
    }
  ],
  "meta": {
    "total": 42,
    "per_page": 10,
    "current_page": 1,
    "last_page": 5
  }
}

​
Get Transaction

Retrieve full details for a single transaction: 
GET /business/transaction/show/{id}
​
id
number
required
The internal numeric transaction ID (the id field, not transaction_id UUID).
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 full payment method details.

​
Track Transaction

Get a live status timeline for any transaction: 
GET /transaction/tracking/{transactionId}
​
transactionId
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",
  "data": [
    {
      "tracking_status": "Payment credited to beneficiary",
      "transaction_type": "withdrawal",
      "created_at": "2026-04-01T10:03:22.000000Z"
    },
    {
      "tracking_status": "With Beneficiary's Bank/Rail",
      "transaction_type": "withdrawal",
      "created_at": "2026-04-01T10:02:54.000000Z"
    },
    {
      "tracking_status": "Processed by Yativo",
      "transaction_type": "withdrawal",
      "created_at": "2026-04-01T10:01:45.000000Z"
    },
    {
      "tracking_status": "Send money initiated",
      "transaction_type": "withdrawal",
      "created_at": "2026-04-01T10:00:00.000000Z"
    }
  ]
}

​
Transactions by Currency

Filter all transactions by a specific currency: 
GET /business/transaction/by-currency?currency={code}
​
currency
string
required
Currency code (e.g. BRL, USD, CLP, MXN).
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/{transactionId}/pdf/receipt
​
transactionId
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'

​
Transaction PIN

Sensitive operations require verification of your 4-digit transaction PIN.

​
Verify PIN

POST /pin/verify
​
pin
string
required
Your 4-digit transaction PIN.
curl -X POST 'https://api.yativo.com/api/v1/pin/verify' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "pin": "1234" }'

​
Set or Update PIN

POST /pin/update
​
pin
string
required
Your new 4-digit PIN.
curl -X POST 'https://api.yativo.com/api/v1/pin/update' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "pin": "5678" }'