Payout Status

Check the status of a payout using your reference_id.

GET https://paygo.sanvexo.in/api/v1/payout/status

Query Parameters

Parameter	Required	Description
`reference_id`	Yes	Your payout reference used at creation

Example

curl -X GET "https://paygo.sanvexo.in/api/v1/payout/status?reference_id=PAY-2024-001" \
  -H "X-API-Key: SVX_your_api_key" \
  -H "X-Secret-Key: SVS_your_secret_key"

$url = "https://paygo.sanvexo.in/api/v1/payout/status?reference_id=PAY-2024-001";
$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => [
    "X-API-Key: SVX_your_api_key",
    "X-Secret-Key: SVS_your_secret_key",
  ],
  CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);

const params = new URLSearchParams({ reference_id: "PAY-2024-001" });
const response = await fetch(`https://paygo.sanvexo.in/api/v1/payout/status?${params}`, {
  headers: {
    "X-API-Key": process.env.PAYGATE_API_KEY,
    "X-Secret-Key": process.env.PAYGATE_SECRET_KEY,
  },
});
const data = await response.json();

import java.net.*;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
String url = "https://paygo.sanvexo.in/api/v1/payout/status?reference_id=PAY-2024-001";

HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create(url))
  .header("X-API-Key", "SVX_your_api_key")
  .header("X-Secret-Key", "SVS_your_secret_key")
  .GET()
  .build();

HttpResponse<String> response = client.send(
  request, HttpResponse.BodyHandlers.ofString()
);

Success Response

{
  "success": true,
  "data": {
    "payout_id": "POXXXXXXXXXXXX",
    "reference_id": "PAY-2024-001",
    "amount": 1000,
    "platform_fee": 15,
    "cgst": 1.35,
    "sgst": 1.35,
    "igst": 0,
    "gst_amount": 2.70,
    "total_fee": 17.70,
    "total_debited": 1017.70,
    "status": "success",
    "beneficiary_id": 1,
    "invoice_number": "INV-2026-000001",
    "utr": "123456789012"
  }
}

Prefer webhooks over polling. Use status API as fallback only.