Payout receipt

{
  "Authorization": "YOUR_API_KEY"
}

curl --location 'https://api.pixtopay.com.br/v2/withdrawals/receipt?id=685' \
--header 'Authorization: API_KEY'

curl --location 'https://api.pixtopay.com.br/v2/withdrawals/receipt?transaction_id=12345678911' \
--header 'Authorization: API_KEY'

{
  "type": "payout",
  "provider": "STARKBANK",
  "id": 685,
  "transaction_id": "12345678911",
  "e2e_id": "E20018183202507030306IVCXWQNh0fQ",
  "filename": "payout_E20018183202507030306IVCXWQNh0fQ.pdf",
  "content_type": "application/pdf",
  "pdf": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBl..."
}

{
  "type": "ValidationError",
  "message": "please provide only one of transaction_id, id"
}

{
  "type": "ValidationError",
  "message": "one of transaction_id, id is required!"
}

{
  "message": "STARKBANK is not enabled for this account."
}

{
  "message": "Receipts are not supported for provider PAGSMILE."
}

{
  "message": "Access to withdrawals is forbidden for this API key!"
}

{
  "message": "Payout not found!"
}

{
  "message": "Receipt not available yet: the transfer has not settled at StarkBank.",
  "detail": "vouchers can only be requested for successful transfers"
}

{
  "message": "Failed to retrieve the receipt from EFIPAY.",
  "detail": "Request failed with status code 403"
}

async function downloadReceipt(transactionId) {
  const response = await fetch(
    `https://api.pixtopay.com.br/v2/withdrawals/receipt?transaction_id=${transactionId}`,
    {
      headers: {
        Authorization: "YOUR_API_KEY",
      },
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message);
  }
 
  const receipt = await response.json();
 
  // Browser: turn the base64 payload into a downloadable file
  const bytes = Uint8Array.from(atob(receipt.pdf), (c) => c.charCodeAt(0));
  const blob = new Blob([bytes], { type: receipt.content_type });
  const url = window.URL.createObjectURL(blob);
  const a = document.createElement("a");
  a.href = url;
  a.download = receipt.filename;
  document.body.appendChild(a);
  a.click();
  a.remove();
  window.URL.revokeObjectURL(url);
}

const fs = require("fs");
 
fs.writeFileSync(receipt.filename, Buffer.from(receipt.pdf, "base64"));

import base64
import requests
 
def download_receipt(transaction_id):
    url = "https://api.pixtopay.com.br/v2/withdrawals/receipt"
    headers = {"Authorization": "YOUR_API_KEY"}
 
    response = requests.get(url, headers=headers, params={"transaction_id": transaction_id})
 
    if response.status_code != 200:
        print(f"Error: {response.json()['message']}")
        return
 
    receipt = response.json()
 
    with open(receipt["filename"], "wb") as f:
        f.write(base64.b64decode(receipt["pdf"]))
 
    print(f"Saved {receipt['filename']}")

<?php
$transactionId = "12345678911";
$url = "https://api.pixtopay.com.br/v2/withdrawals/receipt?transaction_id=" . urlencode($transactionId);
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: YOUR_API_KEY']);
 
$output = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
 
$body = json_decode($output, true);
 
if ($httpCode === 200) {
    file_put_contents($body['filename'], base64_decode($body['pdf']));
    echo "Saved " . $body['filename'];
} else {
    echo "Error: " . $body['message'];
}
?>