Receiptify API Docs

const { Client, GatewayIntentBits, SlashCommandBuilder, REST,
        Routes, EmbedBuilder } = require("discord.js");

const DISCORD_TOKEN  = process.env.DISCORD_TOKEN  || "YOUR_DISCORD_TOKEN";
const CLIENT_ID      = process.env.CLIENT_ID      || "YOUR_CLIENT_ID";
const RECEIPTIFY_KEY = process.env.RECEIPTIFY_KEY || "rcptfy_live_YOUR_KEY";
const BASE    = "https://api.reciptifydev.xyz/v1";
const HEADERS = { "Authorization": `Bearer ${RECEIPTIFY_KEY}`, "Content-Type": "application/json" };

async function apiGet(path) {
  return (await fetch(`${BASE}${path}`, { headers: HEADERS })).json();
}
async function apiPost(path, body = {}, idempotencyKey = null) {
  const h = { ...HEADERS };
  if (idempotencyKey) h["Idempotency-Key"] = idempotencyKey;
  return (await fetch(`${BASE}${path}`, { method:"POST", headers:h, body:JSON.stringify(body) })).json();
}

const commands = [
  new SlashCommandBuilder().setName("receipt").setDescription("Generate a brand receipt")
    .addStringOption(o => o.setName("brand").setDescription("Brand slug e.g. nike").setRequired(true))
    .addStringOption(o => o.setName("url").setDescription("Product URL").setRequired(true))
    .addStringOption(o => o.setName("price").setDescription("Price e.g. 110.00").setRequired(true))
    .addStringOption(o => o.setName("email").setDescription("Recipient email").setRequired(true))
    .addStringOption(o => o.setName("currency").setDescription("$ £ € ¥").setRequired(false))
    .addStringOption(o => o.setName("size").setDescription("Size e.g. UK 9").setRequired(false)),
  new SlashCommandBuilder().setName("brands").setDescription("List brands")
    .addStringOption(o => o.setName("region").setDescription("US | DE | AUTH").setRequired(false)),
  new SlashCommandBuilder().setName("usage").setDescription("Check API quota"),
  new SlashCommandBuilder().setName("history").setDescription("Recent receipts")
    .addStringOption(o => o.setName("brand").setDescription("Filter brand").setRequired(false)),
];

new REST().setToken(DISCORD_TOKEN).put(Routes.applicationCommands(CLIENT_ID),
  { body: commands.map(c => c.toJSON()) }).then(() => console.log("✅ Commands registered"));

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.on("interactionCreate", async interaction => {
  if (!interaction.isChatInputCommand()) return;
  await interaction.deferReply({ ephemeral: true });
  const { commandName: cmd } = interaction;

  if (cmd === "receipt") {
    const brand    = interaction.options.getString("brand");
    const url      = interaction.options.getString("url");
    const price    = interaction.options.getString("price");
    const email    = interaction.options.getString("email");
    const currency = interaction.options.getString("currency") || "£";
    const size     = interaction.options.getString("size") || "";

    const vr = await apiPost("/validate", { brand, product_url: url, price, currency });
    if (!vr?.data?.valid) {
      return interaction.followUp({ content: vr?.data?.discord_feedback || "❌ Validation failed", ephemeral: true });
    }
    const body = { brand: vr.data.brand_slug, product_url: url, price, currency, recipient_email: email };
    if (size) body.size = size;
    const gr = await apiPost("/generate", body, `${interaction.user.id}-${vr.data.brand_slug}-${price}`);

    if (gr?.success) {
      const d = gr.data;
      const e = new EmbedBuilder().setTitle("✅ Receipt Generated").setColor(0xf97316)
        .addFields(
          { name:"Brand",      value:vr.data.brand_info.name, inline:true },
          { name:"Order #",    value:d.order_number,          inline:true },
          { name:"Sent to",    value:d.sent_to,               inline:true },
          { name:"Product",    value:d.product_name,          inline:false },
          { name:"Price",      value:`${currency}${price}`,   inline:true },
          { name:"Receipt ID", value:``${d.receipt_id}``,   inline:true },
        ).setFooter({ text: `Receiptify · ${d.test_mode ? "🧪 Test":"✅ Live"}` });
      return interaction.followUp({ embeds: [e], ephemeral: true });
    }
    return interaction.followUp({ content: gr?.error?.discord_feedback || "❌ Failed.", ephemeral: true });
  }

  if (cmd === "brands") {
    const region = interaction.options.getString("region") || "";
    const data   = await apiGet(`/brands${region ? "?region="+region : ""}`);
    const lines  = data.data.brands.slice(0,25).map(b => ``${b.slug}` — ${b.name}`).join("
");
    return interaction.followUp({
      embeds: [new EmbedBuilder().setTitle(`📦 Brands (${data.data.total})`).setDescription(lines).setColor(0xf97316)],
      ephemeral: true
    });
  }

  if (cmd === "usage") {
    const d = (await apiGet("/usage")).data;
    return interaction.followUp({
      embeds: [new EmbedBuilder().setTitle("📊 Quota").setColor(0xf97316)
        .addFields({ name:"Summary", value:d.discord_summary, inline:false },
                   { name:"Bar",     value:``${d.bar}``,    inline:false })],
      ephemeral: true
    });
  }

  if (cmd === "history") {
    const brand = interaction.options.getString("brand") || "";
    const data  = await apiGet(`/receipts?limit=5${brand ? "&brand="+brand : ""}`);
    const recs  = data.data.receipts;
    if (!recs.length) return interaction.followUp({ content:"No receipts.", ephemeral:true });
    const e = new EmbedBuilder().setTitle("🧾 Receipt History").setColor(0xf97316);
    recs.forEach(r => e.addFields({ name:`${r.brand} — #${r.order_number}`,
      value:``${r.receipt_id}` · ${r.price}${r.currency} · ${r.created_at?.slice(0,10)}`, inline:false }));
    return interaction.followUp({ embeds: [e], ephemeral: true });
  }
});

client.once("ready", () => console.log(`✅ Logged in as ${client.user.tag}`));
client.login(DISCORD_TOKEN);

import os, aiohttp
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, ConversationHandler, filters, ContextTypes

TELEGRAM_TOKEN = os.getenv("TELEGRAM_TOKEN", "YOUR_TELEGRAM_TOKEN")
RECEIPTIFY_KEY = os.getenv("RECEIPTIFY_KEY", "rcptfy_live_YOUR_KEY")
BASE    = "https://api.reciptifydev.xyz/v1"
HEADERS = {"Authorization": f"Bearer {RECEIPTIFY_KEY}"}
BRAND, URL, PRICE, EMAIL, SIZE = range(5)

async def api_post(path, body={}, idem=None):
    h = {**HEADERS, "Content-Type": "application/json"}
    if idem: h["Idempotency-Key"] = idem
    async with aiohttp.ClientSession() as s:
        async with s.post(f"{BASE}{path}", json=body, headers=h) as r:
            return await r.json()

async def api_get(path):
    async with aiohttp.ClientSession() as s:
        async with s.get(f"{BASE}{path}", headers=HEADERS) as r:
            return await r.json()

async def start(u: Update, _):
    await u.message.reply_text(
        "👋 *Receiptify Bot*

"
        "/receipt — Generate a receipt
"
        "/brands — Browse brands
"
        "/usage — Check your quota
"
        "/history — Recent receipts",
        parse_mode="Markdown"
    )

async def brands(u: Update, ctx):
    region = ctx.args[0].upper() if ctx.args else ""
    d = await api_get(f"/brands{'?region='+region if region else ''}")
    lines = "
".join(f"`{b['slug']}` — {b['name']}" for b in d["data"]["brands"][:25])
    await u.message.reply_text(f"📦 *Brands ({d['data']['total']})*

{lines}", parse_mode="Markdown")

async def usage(u: Update, _):
    d = (await api_get("/usage"))["data"]
    await u.message.reply_text(
        f"📊 *API Quota*

{d['discord_summary']}
`{d['bar']}`",
        parse_mode="Markdown"
    )

async def history(u: Update, _):
    d = await api_get("/receipts?limit=5")
    recs = d["data"]["receipts"]
    if not recs: return await u.message.reply_text("No receipts found.")
    lines = [f"*{r['brand']}* — #{r['order_number']}
`{r['receipt_id']}` · {r['price']}{r['currency']} · {r['created_at'][:10]}" for r in recs]
    await u.message.reply_text("🧾 *Recent Receipts*

" + "

".join(lines), parse_mode="Markdown")

async def receipt_start(u: Update, _):
    await u.message.reply_text("What *brand*? e.g. `nike`, `louisvuitton`
/cancel to stop.", parse_mode="Markdown")
    return BRAND

async def get_brand(u: Update, ctx):
    ctx.user_data["brand"] = u.message.text.strip().lower()
    await u.message.reply_text("Paste the full *product URL*:", parse_mode="Markdown")
    return URL

async def get_url(u: Update, ctx):
    ctx.user_data["url"] = u.message.text.strip()
    await u.message.reply_text("*Price*? e.g. `110.00` (no symbol):", parse_mode="Markdown")
    return PRICE

async def get_price(u: Update, ctx):
    ctx.user_data["price"] = u.message.text.strip()
    await u.message.reply_text("*Email* to receive receipt:", parse_mode="Markdown")
    return EMAIL

async def get_email(u: Update, ctx):
    ctx.user_data["email"] = u.message.text.strip()
    await u.message.reply_text("*Size*? e.g. `UK 9` — or `-` to skip:", parse_mode="Markdown")
    return SIZE

async def get_size(u: Update, ctx):
    size  = u.message.text.strip()
    brand = ctx.user_data["brand"]
    url   = ctx.user_data["url"]
    price = ctx.user_data["price"]
    email = ctx.user_data["email"]
    uid   = u.effective_user.id
    await u.message.reply_text("⏳ Generating...")

    vr = await api_post("/validate", {"brand": brand, "product_url": url, "price": price})
    if not vr["data"]["valid"]:
        fb = vr["data"]["discord_feedback"].replace("**", "*")
        await u.message.reply_text(fb, parse_mode="Markdown")
        return ConversationHandler.END

    slug = vr["data"]["brand_slug"]
    body = {"brand": slug, "product_url": url, "price": price, "currency": "£", "recipient_email": email}
    if size and size != "-": body["size"] = size
    gr = await api_post("/generate", body, idem=f"tg-{uid}-{slug}-{price}")

    if gr["success"]:
        d = gr["data"]
        await u.message.reply_text(
            f"✅ *Receipt Sent!*

"
            f"🏷 Brand: *{d['brand']}*
"
            f"🔢 Order: `{d['order_number']}`
"
            f"📦 Product: {d['product_name']}
"
            f"📧 Sent to: `{d['sent_to']}`
"
            f"🪙 ID: `{d['receipt_id']}`",
            parse_mode="Markdown"
        )
    else:
        await u.message.reply_text(gr["error"]["discord_feedback"].replace("**","*"), parse_mode="Markdown")
    return ConversationHandler.END

async def cancel(u: Update, _):
    await u.message.reply_text("Cancelled.")
    return ConversationHandler.END

def main():
    app = Application.builder().token(TELEGRAM_TOKEN).build()
    conv = ConversationHandler(
        entry_points=[CommandHandler("receipt", receipt_start)],
        states={
            BRAND: [MessageHandler(filters.TEXT & ~filters.COMMAND, get_brand)],
            URL:   [MessageHandler(filters.TEXT & ~filters.COMMAND, get_url)],
            PRICE: [MessageHandler(filters.TEXT & ~filters.COMMAND, get_price)],
            EMAIL: [MessageHandler(filters.TEXT & ~filters.COMMAND, get_email)],
            SIZE:  [MessageHandler(filters.TEXT & ~filters.COMMAND, get_size)],
        },
        fallbacks=[CommandHandler("cancel", cancel)],
    )
    app.add_handler(CommandHandler("start",   start))
    app.add_handler(CommandHandler("brands",  brands))
    app.add_handler(CommandHandler("usage",   usage))
    app.add_handler(CommandHandler("history", history))
    app.add_handler(conv)
    print("✅ Telegram bot running...")
    app.run_polling()

if __name__ == "__main__":
    main()

<!-- Receiptify Widget — replace rcptfy_live_YOUR_KEY -->
<div id="rcw">
<style>
  #rcw *{box-sizing:border-box;font-family:system-ui,sans-serif}
  #rcf{background:#0c0c0c;border:1px solid #1e1e1e;border-radius:12px;padding:24px;max-width:420px;margin:0 auto}
  #rcf h2{font-size:17px;font-weight:700;color:#fafafa;margin-bottom:3px}
  #rcf p{font-size:12px;color:#52525b;margin-bottom:18px}
  .rr{display:grid;grid-template-columns:1fr 1fr;gap:8px}
  .rf{margin-bottom:12px}
  .rf label{display:block;font-size:10px;font-weight:600;color:#a1a1aa;margin-bottom:4px;text-transform:uppercase;letter-spacing:.5px}
  .rf input,.rf select{width:100%;background:#080808;border:1px solid #1e1e1e;border-radius:6px;padding:8px 10px;font-size:12px;color:#fafafa;outline:none;transition:border .15s}
  .rf input:focus,.rf select:focus{border-color:#f97316}
  .rf select option{background:#0c0c0c}
  #rcb{width:100%;background:#f97316;color:#fff;font-size:13px;font-weight:700;border:none;border-radius:8px;padding:11px;cursor:pointer;transition:background .15s}
  #rcb:hover{background:#ea580c}#rcb:disabled{background:#27272a;cursor:not-allowed}
  #rcm{margin-top:12px;padding:10px 13px;border-radius:7px;font-size:12px;display:none;line-height:1.5}
  #rcm.ok{background:rgba(34,197,94,.08);border:1px solid rgba(34,197,94,.2);color:#4ade80}
  #rcm.err{background:rgba(239,68,68,.06);border:1px solid rgba(239,68,68,.15);color:#f87171}
</style>
<form id="rcf" onsubmit="rcSubmit(event)">
  <h2>🧾 Generate Receipt</h2>
  <p>Enter your details and get a receipt in seconds.</p>
  <div class="rf"><label>Brand</label><input id="rcbrand" placeholder="e.g. nike" required/></div>
  <div class="rf"><label>Product URL</label><input id="rcurl" type="url" placeholder="https://..." required/></div>
  <div class="rr">
    <div class="rf"><label>Price</label><input id="rcprice" placeholder="110.00" required/></div>
    <div class="rf"><label>Currency</label>
      <select id="rccurr"><option value="£">£ GBP</option><option value="$">$ USD</option>
        <option value="€">€ EUR</option><option value="¥">¥ JPY</option></select></div>
  </div>
  <div class="rr">
    <div class="rf"><label>Email</label><input id="rcemail" type="email" placeholder="you@gmail.com" required/></div>
    <div class="rf"><label>Size (optional)</label><input id="rcsize" placeholder="UK 9"/></div>
  </div>
  <button type="submit" id="rcb">Generate Receipt</button>
  <div id="rcm"></div>
</form>
<script>
const KEY  = "rcptfy_live_YOUR_KEY";
const BASE = "https://api.reciptifydev.xyz/v1";
const H    = { "Authorization": `Bearer ${KEY}`, "Content-Type": "application/json" };

async function post(p, b) {
  return (await fetch(`${BASE}${p}`, { method:"POST", headers:H, body:JSON.stringify(b) })).json();
}
function msg(t, type) {
  const el = document.getElementById("rcm");
  el.innerHTML = t; el.className = type; el.style.display = "block";
}
async function rcSubmit(e) {
  e.preventDefault();
  const btn   = document.getElementById("rcb");
  const brand = document.getElementById("rcbrand").value.trim();
  const url   = document.getElementById("rcurl").value.trim();
  const price = document.getElementById("rcprice").value.trim();
  const curr  = document.getElementById("rccurr").value;
  const email = document.getElementById("rcemail").value.trim();
  const size  = document.getElementById("rcsize").value.trim();
  btn.disabled = true; btn.textContent = "Validating...";
  const vr = await post("/validate", { brand, product_url:url, price, currency:curr });
  if (!vr?.data?.valid) {
    msg("❌ " + Object.values(vr?.data?.issues||{}).join("<br>"), "err");
    btn.disabled = false; btn.textContent = "Generate Receipt"; return;
  }
  btn.textContent = "Generating...";
  const body = { brand:vr.data.brand_slug, product_url:url, price, currency:curr, recipient_email:email };
  if (size) body.size = size;
  const gr = await post("/generate", body);
  if (gr?.success) {
    const d = gr.data;
    msg(`✅ <b>Receipt sent!</b><br>Order #${d.order_number} · ${d.product_name}<br>Sent to ${d.sent_to}`, "ok");
  } else {
    msg("❌ " + (gr?.error?.message||"Generation failed."), "err");
  }
  btn.disabled = false; btn.textContent = "Generate Receipt";
}
</script>
</div>

<?php
/**
 * Receiptify PHP Integration
 * Requires: PHP 7.4+, curl extension
 * Usage: include this file and call Receiptify::generate(...)
 */

class Receiptify {
    const API_KEY = "rcptfy_live_YOUR_KEY";
    const BASE    = "https://api.reciptifydev.xyz/v1";

    private static function call(string $method, string $path, array $body = [], string $idem = null): array {
        $headers = [
            "Authorization: Bearer " . self::API_KEY,
            "Content-Type: application/json",
        ];
        if ($idem) $headers[] = "Idempotency-Key: $idem";

        $ch = curl_init(self::BASE . $path);
        curl_setopt_array($ch, [
            CURLOPT_CUSTOMREQUEST  => $method,
            CURLOPT_POSTFIELDS     => $body ? json_encode($body) : null,
            CURLOPT_HTTPHEADER     => $headers,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 30,
            CURLOPT_SSL_VERIFYPEER => true,
        ]);
        $res = json_decode(curl_exec($ch), true);
        curl_close($ch);
        return $res ?? ["success" => false, "error" => ["message" => "curl failed"]];
    }

    public static function validate(string $brand, string $url, string $price): array {
        return self::call("POST", "/validate", compact("brand") + ["product_url" => $url, "price" => $price]);
    }

    public static function generate(string $brand, string $url, string $price,
        string $email, string $currency = "£", string $size = "", string $externalId = ""): array {
        $body = ["brand" => $brand, "product_url" => $url, "price" => $price,
                 "currency" => $currency, "recipient_email" => $email];
        if ($size)       $body["size"]        = $size;
        if ($externalId) $body["external_id"] = $externalId;
        $idem = "php-" . md5($brand . $price . $email);
        return self::call("POST", "/generate", $body, $idem);
    }

    public static function usage(): array {
        return self::call("GET", "/usage");
    }

    public static function brands(string $region = ""): array {
        return self::call("GET", "/brands" . ($region ? "?region=$region" : ""));
    }

    public static function receipts(int $limit = 10, string $brand = ""): array {
        $q = "?limit=$limit" . ($brand ? "&brand=$brand" : "");
        return self::call("GET", "/receipts" . $q);
    }
}

/* ─── Usage examples ─────────────────────────────────────────────────────────
// Validate first (free)
$vr = Receiptify::validate("nike", "https://www.nike.com/...", "110.00");
if (!$vr["data"]["valid"]) {
    die($vr["data"]["discord_feedback"]);  // human-readable error
}

// Generate
$gr = Receiptify::generate(
    brand:       "nike",
    url:         "https://www.nike.com/t/air-force-1-07/CW2288-111",
    price:       "110.00",
    email:       "buyer@gmail.com",
    currency:    "£",
    size:        "UK 9",
    externalId:  "order_" . uniqid()
);

if ($gr["success"]) {
    $d = $gr["data"];
    echo "✅ Receipt sent! Order #{$d['order_number']} — {$d['product_name']}";
} else {
    echo "❌ " . $gr["error"]["message"];
}

// Check quota
$usage = Receiptify::usage();
echo $usage["data"]["discord_summary"];  // "**453** requests left out of **500**"
────────────────────────────────────────────────────────────────────────────── */