Transactions

Type Definitions

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}

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'

const response = await client.get(`/business/transaction/${txId}/pdf/receipt`);
const pdfBuffer = Buffer.from(response.data, 'base64');
fs.writeFileSync('receipt.pdf', pdfBuffer);

Transaction PIN

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

Verify PIN

POST /pin/verify

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

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" }'

Get Started

Payments

Wallets

Customers & Compliance

Products

Developer Tools

Regional Guides

Transactions

List Transactions

Get Transaction

Track Transaction

Transactions by Currency

Download Receipt (PDF)

Transaction PIN

Verify PIN

Set or Update PIN

​List Transactions

​Get Transaction

​Track Transaction

​Transactions by Currency

​Download Receipt (PDF)

​Transaction PIN

​Verify PIN

​Set or Update PIN

List Transactions

Get Transaction

Track Transaction

Transactions by Currency

Download Receipt (PDF)

Transaction PIN

Verify PIN

Set or Update PIN