🇬🇧
Yativo Documentation
Spanish
English
English
  • Yativo
  • Introduction to Yativo
    • Financial Infrastructure
    • About Us
  • Dashboard
  • Business Plans
  • Getting Started with Yativo API
  • Yativo API Glossary
  • API reference
    • Misc.
      • Countries
      • States
      • City
  • Security and Authentication
    • Security
    • Authentication
    • Idempotency in API Requests
  • Environment
    • Environments
  • Notifications
    • Webhook
  • Compliance
    • Verification
      • KYC
      • KYB
      • KYC/KYB Update
      • KYC Status
      • Global Business Search
    • Supported Jurisdiction
    • Supported Countries, Currencies and Payment Method
  • User Management
    • Customer
      • Get Customers
      • Retrieve customer
      • Add Customer
  • Payments
    • Currencies
    • Crypto Wallets
      • Generate Wallet Address
      • Fetch Wallet Address
      • Crypto Deposit History
      • Single crypto deposit history
    • Payout
      • Payout
      • Get Payouts
      • Get Payout
      • Beneficiaries
        • Get Beneficiaries
        • Add Beneficiary Payment Details
        • Update Beneficiary
        • Archive Beneficiary
        • Add Beneficiary
    • Payin
    • Virtual Cards
      • Supported Currency, Country
      • Create card
      • Fetch card
      • Top up card
      • Get Transactions
      • Freeze and Unfreeze Card
    • Virtual Accounts
      • Create VIrtual Accounts
        • USD Virtual Account
        • Mexico Virtual Account
        • Brazil PIX QR
      • Virtual Account Management
      • Transaction History
  • Foreign Exchange
    • Exchange Rate
      • Request Quote
  • Transactions
    • Transaction Summary
    • Get Single Transaction
  • Crypto System
    • Yativo Crypto Platform API
Powered by GitBook
On this page
  1. Payments
  2. Virtual Accounts

Transaction History

Fetch Virtual Account Transaction History

Endpoint

POST {{baseUrl}}/business/virtual-account/history/{{accountNumber}}

Description

This endpoint allows you to fetch the transaction history of a virtual account.

Request

Headers

  • Content-Type: application/json

  • Authorization: Bearer {your_api_token}

Path Parameters

Parameter
Type
Required
Description

user_id

string

Yes

Unique identifier of the user

Example Request

POST {{baseUrl}}/business/virtual-account/history/{{accountNumber}}
Authorization: Bearer your_api_token
Content-Type: application/json

<?php

$user_id = "123456";
$api_token = "your_api_token";
$base_url = "{{baseUrl}}";
$url = "$base_url/business/virtual-account/history/{{accountNumber}}

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Authorization: Bearer $api_token",
    "Content-Type: application/json"
));

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>
const user_id = "123456";
const api_token = "your_api_token";
const base_url = "{{baseUrl}}";
const url = `${base_url}/business/virtual-account/history/{{accountNumber}}
fetch(url, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${api_token}`,
        'Content-Type': 'application/json'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error('Network response was not ok ' + response.statusText);
    }
    return response.json();
})
.then(data => console.log(data))
.catch(error => console.error('There was a problem with your fetch operation:', error));
curl -X GET {{baseUrl}}/business/virtual-account/history/{{accountNumber}} \
     -H "Authorization: Bearer your_api_token" \
     -H "Content-Type: application/json"

PreviousVirtual Account ManagementNextExchange Rate

Last updated 2 months ago

Fetch Account Histories

post
Authorizations
Path parameters
accountNumberstringRequired
Responses
400
Bad Request
application/json
post
POST /api/v1/business/virtual-account/history/{accountNumber} HTTP/1.1
Host: smtp.yativo.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
400

Bad Request

{
  "status": "text",
  "status_code": 1,
  "message": "text",
  "data": [
    {
      "id": 1,
      "external_id": "text",
      "internal_id": "text",
      "transaction_type": "text",
      "amount": "text",
      "provider_response": {
        "date": {
          "creationDate": "2024-09-06T11:40:13Z",
          "processedDate": "2024-09-06T11:40:13Z"
        },
        "fees": {
          "amount": 1,
          "account": "text",
          "fxQuote": 1,
          "currency": "text",
          "fxSource": 1,
          "description": "text"
        },
        "payer": {
          "bank": {
            "code": "710",
            "name": "NVIO",
            "branch": [],
            "account": {
              "type": "C",
              "number": "710969000035509567"
            }
          },
          "name": "Zee Technologies SPA",
          "type": "INDIVIDUAL",
          "email": "NA",
          "document": {
            "id": "ND",
            "type": "ND"
          },
          "lastName": "Zee Technologies SPA"
        },
        "amount": 1,
        "errors": [
          "text"
        ],
        "status": {
          "code": "200",
          "detail": "The payin was credited",
          "description": "COMPLETED"
        },
        "country": "text",
        "payment": {
          "amount": 1,
          "fxQuote": 1,
          "currency": "text",
          "financingFee": 1
        },
        "currency": "text",
        "merchant": {
          "name": "Zee Technologies SPA",
          "type": "COMPANY"
        },
        "tracking": {
          "id": "202409069071001080000509802957",
          "concept": "nd",
          "reference": "1"
        },
        "confirmed": {
          "amount": 1,
          "fxQuote": 1,
          "currency": "text"
        },
        "externalId": "text",
        "internalId": "text",
        "localTaxes": [
          "text"
        ],
        "beneficiary": {
          "bank": {
            "account": {
              "number": "646010319801292000"
            }
          },
          "name": "Ogechi",
          "type": "INDIVIDUAL",
          "document": {
            "id": "A1009098",
            "type": "PASSPORT"
          },
          "lastName": null,
          "informedName": "John Smith"
        },
        "withHoldings": [
          "text"
        ],
        "accountNumber": "text",
        "paymentMethod": {
          "code": "1630",
          "flow": "DIRECT",
          "type": "BankTransfer"
        },
        "referenceCode": "text",
        "transactionType": "text",
        "redirectUrl": "text",
        "intermediaries": [
          "text"
        ],
        "wireInstructions": [
          "text"
        ]
      },
      "created_at": "text",
      "updated_at": "text",
      "account_number": "text"
    }
  ],
  "pagination": {
    "total": 63,
    "per_page": 10,
    "current_page": 1,
    "last_page": 7,
    "next_page_url": "http://127.0.0.1:9000/api/v1/business/virtual-account/history/646010319801302039?page=2",
    "prev_page_url": null
  }
}
  • Fetch Virtual Account Transaction History
  • POSTFetch Account Histories