PDF Receipt Generator - SimpleWebAPIs

Overview

The PDF Receipt Generator creates professional PDF receipts from structured JSON data. Include seller and customer addresses, line items with prices and quantities, payment details, tax information, and custom styling.

Endpoint

POST /api/receipt

Request Body

Field	Type	Required	Description
receiptNumber	int	No	Receipt number (auto-generated if omitted)
date	string	No	Receipt date (ISO 8601, defaults to today)
seller	object	No	Seller info (name, addressLines, email, phone)
customer	object	No	Customer info (same fields as seller)
items	array	Yes	Line items (each: name, price, quantity)
amountPaid	decimal	No	Amount paid (calculated from items if omitted)
paymentMethod	string	No	Payment method (e.g. "Credit Card", "Cash", "PayPal")
transactionId	string	No	Transaction or reference ID
taxAmount	decimal	No	Tax amount added to the total
comments	string	No	Optional comments or notes
logoUrl	string	No	URL of the logo image (PNG, JPG, SVG) rendered in the header
accentColor	string	No	Hex color for receipt heading and label (default: #3B82F6)
textColor	string	No	Hex color for primary text (default: #1F2937)
mutedTextColor	string	No	Hex color for secondary/muted text (default: #6B7280)
separatorColor	string	No	Hex color for table row borders and address underlines (default: #E5E7EB)
notesBackgroundColor	string	No	Hex color for the notes box background (default: #F3F4F6)
currency	string	No	ISO 4217 currency code (e.g. "USD", "EUR", "GBP"). Defaults to "USD"

Example

Generate a PDF receipt:

curl -X POST https://simplewebapis.com/api/receipt \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: swa_your_key" \
  -d '{
    "receiptNumber": 5001,
    "date": "2025-07-15",
    "seller": { "name": "Acme Corp", "addressLines": ["123 Seller St", "San Francisco, CA 94105"], "email": "[email protected]" },
    "customer": { "name": "Globex Inc", "addressLines": ["456 Customer Ave", "New York, NY 10001"], "email": "[email protected]" },
    "items": [
      { "name": "Web Development", "price": 1500.00, "quantity": 1 },
      { "name": "UI Design", "price": 800.00, "quantity": 2 }
    ],
    "amountPaid": 3100.00,
    "paymentMethod": "Credit Card",
    "transactionId": "TXN-2025-0715-001",
    "taxAmount": 240.00,
    "comments": "Thank you for your purchase!",
    "currency": "USD",
    "logoUrl": "https://simplewebapis.com/favicon-32x32.png",
    "accentColor": "#2563EB",
    "separatorColor": "#E5E7EB",
    "notesBackgroundColor": "#F9FAFB"
  }' --output receipt.pdf

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "swa_your_key");

var payload = new
{
    receiptNumber = 5001,
    date = "2025-07-15",
    seller = new { name = "Acme Corp", addressLines = new[] { "123 Seller St", "San Francisco, CA 94105" }, email = "[email protected]" },
    customer = new { name = "Globex Inc", addressLines = new[] { "456 Customer Ave", "New York, NY 10001" }, email = "[email protected]" },
    items = new[]
    {
        new { name = "Web Development", price = 1500.00m, quantity = 1 },
        new { name = "UI Design", price = 800.00m, quantity = 2 }
    },
    amountPaid = 3100.00m,
    paymentMethod = "Credit Card",
    transactionId = "TXN-2025-0715-001",
    taxAmount = 240.00m,
    comments = "Thank you for your purchase!",
    Currency = "USD",
    LogoUrl = "https://simplewebapis.com/favicon-32x32.png",
    accentColor = "#2563EB",
    separatorColor = "#E5E7EB",
    notesBackgroundColor = "#F9FAFB"
};

var json = JsonSerializer.Serialize(payload);
var content = new StringContent(json, Encoding.UTF8, "application/json");

var response = await client.PostAsync(
    "https://simplewebapis.com/api/receipt", content);
var pdfBytes = await response.Content.ReadAsByteArrayAsync();
await File.WriteAllBytesAsync("receipt.pdf", pdfBytes);

$payload = json_encode([
    'receiptNumber' => 5001,
    'date' => '2025-07-15',
    'seller' => ['name' => 'Acme Corp', 'addressLines' => ['123 Seller St', 'San Francisco, CA 94105'], 'email' => '[email protected]'],
    'customer' => ['name' => 'Globex Inc', 'addressLines' => ['456 Customer Ave', 'New York, NY 10001'], 'email' => '[email protected]'],
    'items' => [
        ['name' => 'Web Development', 'price' => 1500.00, 'quantity' => 1],
        ['name' => 'UI Design', 'price' => 800.00, 'quantity' => 2],
    ],
    'amountPaid' => 3100.00,
    'paymentMethod' => 'Credit Card',
    'transactionId' => 'TXN-2025-0715-001',
    'taxAmount' => 240.00,
    'comments' => 'Thank you for your purchase!',
    'currency' => 'USD',
    'logoUrl' => 'https://simplewebapis.com/favicon-32x32.png',
    'accentColor' => '#2563EB',
    'separatorColor' => '#E5E7EB',
    'notesBackgroundColor' => '#F9FAFB',
]);

$ch = curl_init('https://simplewebapis.com/api/receipt');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-Api-Key: swa_your_key',
    ],
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
]);

$pdf = curl_exec($ch);
curl_close($ch);
file_put_contents('receipt.pdf', $pdf);

const response = await fetch('https://simplewebapis.com/api/receipt', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Api-Key': 'swa_your_key',
    },
    body: JSON.stringify({
        receiptNumber: 5001,
        date: '2025-07-15',
        seller: { name: 'Acme Corp', addressLines: ['123 Seller St', 'San Francisco, CA 94105'], email: '[email protected]' },
        customer: { name: 'Globex Inc', addressLines: ['456 Customer Ave', 'New York, NY 10001'], email: '[email protected]' },
        items: [
            { name: 'Web Development', price: 1500.00, quantity: 1 },
            { name: 'UI Design', price: 800.00, quantity: 2 },
        ],
        amountPaid: 3100.00,
        paymentMethod: 'Credit Card',
        transactionId: 'TXN-2025-0715-001',
        taxAmount: 240.00,
        comments: 'Thank you for your purchase!',
        currency: 'USD',
        logoUrl: 'https://simplewebapis.com/favicon-32x32.png',
        accentColor: '#2563EB',
        separatorColor: '#E5E7EB',
        notesBackgroundColor: '#F9FAFB',
    }),
});

const buffer = await response.arrayBuffer();
const fs = require('fs');
fs.writeFileSync('receipt.pdf', Buffer.from(buffer));

import requests

response = requests.post(
    'https://simplewebapis.com/api/receipt',
    headers={
        'Content-Type': 'application/json',
        'X-Api-Key': 'swa_your_key',
    },
    json={
        'receiptNumber': 5001,
        'date': '2025-07-15',
        'seller': {'name': 'Acme Corp', 'addressLines': ['123 Seller St', 'San Francisco, CA 94105'], 'email': '[email protected]'},
        'customer': {'name': 'Globex Inc', 'addressLines': ['456 Customer Ave', 'New York, NY 10001'], 'email': '[email protected]'},
        'items': [
            {'name': 'Web Development', 'price': 1500.00, 'quantity': 1},
            {'name': 'UI Design', 'price': 800.00, 'quantity': 2},
        ],
        'amountPaid': 3100.00,
        'paymentMethod': 'Credit Card',
        'transactionId': 'TXN-2025-0715-001',
        'taxAmount': 240.00,
        'comments': 'Thank you for your purchase!',
        'currency': 'USD',
        'logoUrl': 'https://simplewebapis.com/favicon-32x32.png',
        'accentColor': '#2563EB',
        'separatorColor': '#E5E7EB',
        'notesBackgroundColor': '#F9FAFB',
    },
)

with open('receipt.pdf', 'wb') as f:
    f.write(response.content)

payload := map[string]interface{}{
    "receiptNumber": 5001,
    "date":          "2025-07-15",
    "seller": map[string]interface{}{
        "name":  "Acme Corp",
        "addressLines": []string{"123 Seller St", "San Francisco, CA 94105"},
        "email":        "[email protected]",
    },
    "customer": map[string]interface{}{
        "name":  "Globex Inc",
        "addressLines": []string{"456 Customer Ave", "New York, NY 10001"},
        "email":        "[email protected]",
    },
    "items": []map[string]interface{}{
        {"name": "Web Development", "price": 1500.00, "quantity": 1},
        {"name": "UI Design", "price": 800.00, "quantity": 2},
    },
    "amountPaid":            3100.00,
    "paymentMethod":         "Credit Card",
    "transactionId":         "TXN-2025-0715-001",
    "taxAmount":             240.00,
    "comments":              "Thank you for your purchase!",
    "currency":              "USD",
    "logoUrl":               "https://simplewebapis.com/favicon-32x32.png",
    "accentColor":           "#2563EB",
    "separatorColor":        "#E5E7EB",
    "notesBackgroundColor":  "#F9FAFB",
}

jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://simplewebapis.com/api/receipt",
    bytes.NewBuffer(jsonData))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Api-Key", "swa_your_key")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
os.WriteFile("receipt.pdf", body, 0644)

require 'net/http'
require 'json'
require 'uri'

payload = {
  receiptNumber: 5001,
  date: '2025-07-15',
  seller: { name: 'Acme Corp', addressLines: ['123 Seller St', 'San Francisco, CA 94105'], email: '[email protected]' },
  customer: { name: 'Globex Inc', addressLines: ['456 Customer Ave', 'New York, NY 10001'], email: '[email protected]' },
  items: [
    { name: 'Web Development', price: 1500.00, quantity: 1 },
    { name: 'UI Design', price: 800.00, quantity: 2 },
  ],
  amountPaid: 3100.00,
  paymentMethod: 'Credit Card',
  transactionId: 'TXN-2025-0715-001',
  taxAmount: 240.00,
  comments: 'Thank you for your purchase!',
  currency: 'USD',
  logo_url: 'https://simplewebapis.com/favicon-32x32.png',
  accentColor: '#2563EB',
  separatorColor: '#E5E7EB',
  notesBackgroundColor: '#F9FAFB',
}

uri = URI('https://simplewebapis.com/api/receipt')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-Api-Key'] = 'swa_your_key'
req.body = payload.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
File.binwrite('receipt.pdf', response.body)

var payload = """
    {
        "receiptNumber": 5001,
        "date": "2025-07-15",
        "seller": { "name": "Acme Corp", "addressLines": ["123 Seller St", "San Francisco, CA 94105"], "email": "[email protected]" },
        "customer": { "name": "Globex Inc", "addressLines": ["456 Customer Ave", "New York, NY 10001"], "email": "[email protected]" },
        "items": [
            { "name": "Web Development", "price": 1500.00, "quantity": 1 },
            { "name": "UI Design", "price": 800.00, "quantity": 2 }
        ],
        "amountPaid": 3100.00,
        "paymentMethod": "Credit Card",
        "transactionId": "TXN-2025-0715-001",
        "taxAmount": 240.00,
        "comments": "Thank you for your purchase!",
        "currency": "USD",
        "logoUrl": "https://simplewebapis.com/favicon-32x32.png",
        "accentColor": "#2563EB",
        "separatorColor": "#E5E7EB",
        "notesBackgroundColor": "#F9FAFB"
    }
    """;

var request = HttpRequest.newBuilder()
    .uri(URI.create("https://simplewebapis.com/api/receipt"))
    .header("Content-Type", "application/json")
    .header("X-Api-Key", "swa_your_key")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

var response = HttpClient.newHttpClient().send(request,
    HttpResponse.BodyHandlers.ofByteArray());
Files.write(Path.of("receipt.pdf"), response.body());

use serde_json::json;
use std::fs;

let client = reqwest::Client::new();
let payload = json!({
    "receiptNumber": 5001,
    "date": "2025-07-15",
    "seller": { "name": "Acme Corp", "addressLines": ["123 Seller St", "San Francisco, CA 94105"], "email": "[email protected]" },
    "customer": { "name": "Globex Inc", "addressLines": ["456 Customer Ave", "New York, NY 10001"], "email": "[email protected]" },
    "items": [
        { "name": "Web Development", "price": 1500.00, "quantity": 1 },
        { "name": "UI Design", "price": 800.00, "quantity": 2 }
    ],
    "amountPaid": 3100.00,
    "paymentMethod": "Credit Card",
    "transactionId": "TXN-2025-0715-001",
    "taxAmount": 240.00,
    "comments": "Thank you for your purchase!",
    "currency": "USD",
    "logoUrl": "https://simplewebapis.com/favicon-32x32.png",
    "accentColor": "#2563EB",
    "separatorColor": "#E5E7EB",
    "notesBackgroundColor": "#F9FAFB"
});

let resp = client.post("https://simplewebapis.com/api/receipt")
    .header("Content-Type", "application/json")
    .header("X-Api-Key", "swa_your_key")
    .json(&payload)
    .send()
    .await?;

let bytes = resp.bytes().await?;
fs::write("receipt.pdf", &bytes)?;

The response is a PDF document (Content-Type: application/pdf).

Try it out

Use the Playground to test this API live.