API Reference
Status

Status API

Check the status of both payin and payout transactions.

Check Transaction Status

POST https://api.payvanta.in/status

Authentication

All API requests must include your Bearer token in the Authorization header:

Authorization: Bearer <base64_encoded_credentials>
Content-Type: application/json

Request

Request Body

FieldTypeRequiredDescription
order_idstringYesThe order ID of the transaction to check (max 15 digits)

Validation Rules

  • order_id: Must be valid and cannot exceed 15 digits

Example Request

{
    "order_id": "551120001211555"
}

Response

Success Response

{
    "success": true,
    "data": {
        "orderId": "551120001211555",
        "status": "SUCCESS",
        "amount": 100,
        "timestamp": "2025-09-22T11:07:31.833Z",
        "utr": "691068796558"
    }
}

Response Fields

FieldTypeDescription
successbooleanIndicates if the request was successful
data.orderIdstringThe order ID of the transaction
data.statusstringCurrent status of the transaction
data.amountnumberAmount of the transaction
data.timestampstringLast update timestamp of the transaction
data.utrstringUTR number (for successful transactions)

Status Values

StatusDescription
PENDINGTransaction is initiated but not completed
SUCCESSTransaction completed successfully
FAILEDTransaction failed

Error Responses

Invalid Request (400)

{
    "success": false,
    "message": "order_id is required"
}

Invalid Order ID (400)

{
    "success": false,
    "message": "INVALID_ORDER_ID",
    "error": "Order ID cannot exceed 15 digits"
}

Transaction Not Found (404)

{
    "success": false,
    "message": "TRANSACTION_NOT_FOUND"
}

Server Error (500)

{
    "success": false,
    "message": "FAILED_TO_CHECK_STATUS"
}

Code Examples

cURL

curl -X POST https://api.payvanta.in/status \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "551120001211555"
  }'

Python

import requests
 
# API endpoint
url = "https://api.payvanta.in/status"
 
# Request headers
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}
 
# Request body
data = {
    "order_id": "551120001211555"
}
 
# Make the request
response = requests.post(url, headers=headers, json=data)
print(response.json())

Node.js

const axios = require('axios');
 
// API endpoint
const url = 'https://api.payvanta.in/status';
 
// Request headers
const headers = {
  'Authorization': `Bearer ${token}`,
  'Content-Type': 'application/json'
};
 
// Request body
const data = {
  order_id: '551120001211555'
};
 
// Make the request
axios.post(url, data, { headers })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

Usage Examples

Check Transaction Status

// Check any transaction status (payin or payout)
const checkStatus = async (orderId) => {
  const response = await fetch('https://api.payvanta.in/status', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ order_id: orderId })
  });
  return response.json();
};
 
// Usage example
const status = await checkStatus('551120001211555');
console.log('Transaction Status:', status.data.status);
console.log('Amount:', status.data.amount);
if (status.data.utr) {
  console.log('UTR:', status.data.utr);
}
PayinPayouts