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

Fetch Account Histories

post

Authorizations

Path parameters

accountNumberstringRequired

Responses

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

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

PHP

<?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);
?>

JavaScript

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

curl -X GET {{baseUrl}}/business/virtual-account/history/{{accountNumber}} \
     -H "Authorization: Bearer your_api_token" \
     -H "Content-Type: application/json"