ਮੁੱਖ ਸਮੱਗਰੀ 'ਤੇ ਜਾਓ
ਸਿੱਖੋਗਾਈਡਵੈੱਬਹੂਕਸ ਨਾਲ ਏਜੰਟ ਭੁਗਤਾਨ ਸੰਭਾਲੋ
ਗਾਈਡ

ਵੈਬਹੁਕ ਪੈਟਰਨ ਜੋ ਵਿਕਾਸਕਾਂ ਨੇ ਸਭ ਤੋਂ ਵੱਧ ਪੁੱਛੇ।

15 ਮਿੰਟ
ਛੋਟੀ ਜਵਾਬ

ਇੱਕ ਭਰੋਸੇਯੋਗ webhook ਹੈਂਡਲਰ ਚਾਰ ਕੰਮ ਕਰਦਾ ਹੈ: ਕੱਚੇ ਸਰੀਰ ਦੇ ਖਿਲਾਫ ਸਾਈਨਚਰ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ (Node ਵਿੱਚ webhooks.verify, ਦਸਤਾਵੇਜ਼ਿਤ HMAC ਹੋਰ ਜਗ੍ਹਾ), ਇਵੈਂਟ ਆਈਡੀ ਦੁਆਰਾ ਡਿਊਪਲੀਕੇਟ ਕਰੋ, ਕੰਮ ਨੂੰ ਇੱਕ ਬੈਕਗ੍ਰਾਊਂਡ ਕਿਊ ਵਿੱਚ ਰੱਖੋ, ਅਤੇ 200 ਵਾਪਸ ਕਰੋ. ਲੰਬੇ ਸਮੇਂ ਤੱਕ ਚੱਲਣ ਵਾਲਾ ਕੰਮ ਵਰਕਰ ਵਿੱਚ ਹੁੰਦਾ ਹੈ, ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ਾਂ ਅਤੇ ਕਿਊ ਪਰਤ 'ਤੇ ਆਈਡੈਂਪੋਟੈਂਸੀ ਨਾਲ. ਕਿਉਂਕਿ ਕੋਈ ਅਸਫਲਤਾ ਘਟਨਾ ਨਹੀਂ ਹੈ, ਇੱਕ ਨਿਯਤ ਸਵੀਪ ਭੁਗਤਾਨ ਦੀ ਉਡੀਕ ਕਰ ਰਹੇ ਕੰਮਾਂ ਨੂੰ ਸਮਾਂ ਬਾਹਰ ਕਰਦਾ ਹੈ ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਸਹੀ ਕਰਦਾ ਹੈ.

ਪੂਰਵ ਸ਼ਰਤਾਂ

ਤੁਸੀਂ ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ।

  • ਇੱਕ ਕੰਮ ਕਰਦਾ ਏਜੰਟ ਪ੍ਰੋਫਾਈਲ ਅਤੇ ਤੁਹਾਡੇ ਡੈਸ਼ਬੋਰਡ ਤੋਂ ਦਸਤਖਤ ਦਾ ਗੁਪਤ (ਸੈਟਿੰਗਜ਼ - ਵੈਬਹੂਕ)।
  • ਇੱਕ ਵੈਬ ਫਰੇਮਵਰਕ ਜਿਸ ਵਿੱਚ ਰਾਅ-ਬਾਡੀ ਪਹੁੰਚ ਹੈ - Express ਨਾਲ express.raw, FastAPI, Flask, ਆਦਿ। ਆਟੋ-ਪਾਰਸਿੰਗ JSON ਮਿਡਲਵੇਅਰ ਦਸਤਖਤ ਦੀ ਪੁਸ਼ਟੀ ਨੂੰ ਤੋੜਦਾ ਹੈ।
  • ਇੱਕ ਨੌਕਰੀ ਕਤਾਰ: BullMQ (Node) ਜਾਂ Celery/arq (Python)। ਵੈਬਹੂਕ 200 ਤੇਜ਼ੀ ਨਾਲ ਵਾਪਸ ਕਰਦਾ ਹੈ ਅਤੇ ਕਤਾਰ ਧੀਰੇ ਕੰਮ ਕਰਦੀ ਹੈ।
  • ਇੱਕ ਡੇਟਾਬੇਸ ਜਿਸ ਵਿੱਚ ਇੱਕ ਅਪਸਰਟ ਪ੍ਰਿਮਿਟਿਵ ਹੈ (Postgres ਕੰਮ ਕਰਦਾ ਹੈ; Redis SET NX ਵੀ ਛੋਟੇ ਸਮੇਂ ਲਈ ਡਿਡਿਊਪ ਲਈ ਕੰਮ ਕਰਦਾ ਹੈ)।
  • ਇੱਕ ਜਨਤਕ HTTPS ਐਂਡਪੋਇੰਟ - ਵਿਕਾਸ ਵਿੱਚ, ngrok ਜਾਂ ਇੱਕ ਡਿਪਲੋਇ ਪ੍ਰੀਵਿਊ। ਭੇਜਨਹਾਰ ਨਿੱਜੀ URLs 'ਤੇ ਡਿਲਿਵਰੀ ਨਹੀਂ ਕਰੇਗਾ।
ਕਦਮ 1 ਵਿੱਚ 4

ਦਸਤਖਤ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ.

The signature is HMAC-SHA256 over {t}.{rawBody} with your webhook secret, hex-encoded, in the X-Blockchain0x-Signature header (t=<unix>,v1=<hex>), inside a 5-minute replay window. In Node, webhooks.verify from @blockchain0x/node does it and returns a discriminated union; in other languages compute the same HMAC and compare in constant time. Raw-body access matters: if the bytes you sign locally differ from the bytes that arrived, it fails.

TypeScript
import express from "express";
import { webhooks } from "@blockchain0x/node";

const app = express();
// Raw body so the HMAC matches the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  // Discriminated union: branch on ok, no try/catch.
  if (!result.ok) return res.status(400).json({ code: result.code });
  // result.eventType / result.eventId are now set.
  handleEvent(result);
  res.status(200).send("ok");
});
Python
import hmac, hashlib, os, time
from flask import request

SECRET = os.environ["BLOCKCHAIN0X_WEBHOOK_SECRET"].encode()

# In Node, webhooks.verify does this. In Python, verify by hand against the
# documented algorithm: HMAC-SHA256 over "{t}.{rawBody}", 300s replay window.
def verify_signature(raw_body: bytes) -> bool:
    sig = request.headers.get("X-Blockchain0x-Signature", "")
    ts = request.headers.get("X-Blockchain0x-Timestamp", "")
    parts = dict(p.split("=", 1) for p in sig.split(",") if "=" in p)
    t, v1 = parts.get("t", ts), parts.get("v1", sig)
    want = hmac.new(SECRET, t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(want, v1) and abs(time.time() - int(t)) <= 300
ਕਦਮ 2 ਵਿੱਚ 4

ਹੈਂਡਲਰ ਨੂੰ ਆਈਡੈਂਪੋਟੈਂਟ ਬਣਾਓ।

Webhooks retry on any non-2xx response, and the same event will arrive multiple times under load even when nothing has gone wrong. Dedupe on the event's id using a database upsert. If the row already exists, skip; if it does not, insert and proceed. Postgres makes this a single statement.

TypeScript
// Pseudocode for a Postgres-backed dedupe table. Replace with your DB of choice.
async function processEventOnce(eventId: string, body: object) {
  // INSERT ... ON CONFLICT DO NOTHING returns rowCount === 0 on duplicate.
  const inserted = await db.query(
    "INSERT INTO webhook_events(id) VALUES ($1) ON CONFLICT DO NOTHING",
    [eventId],
  );
  if (inserted.rowCount === 0) return;          // Already processed.
  await handleEvent(body);
}
Python
async def process_event_once(event_id: str, body: dict):
    # INSERT ... ON CONFLICT DO NOTHING returns 0 rows on duplicate.
    inserted = await db.execute(
        "INSERT INTO webhook_events (id) VALUES ($1) ON CONFLICT DO NOTHING",
        event_id,
    )
    if inserted == "INSERT 0 0":   # asyncpg-style status
        return                     # Already processed.
    await handle_event(body)
ਕਦਮ 3 ਵਿੱਚ 4

ਇਨਕਿਊ ਅਤੇ 200 ਤੇਜ਼ ਵਾਪਸ ਕਰੋ।

ਵੈਬਹੁਕ ਐਂਡਪੋਇੰਟ ਨੂੰ ਇੱਕ ਸਕਿੰਟ ਦੇ ਅੰਦਰ ਜਵਾਬ ਦੇਣਾ ਚਾਹੀਦਾ ਹੈ। ਕੁਝ ਵੀ ਹੌਲੀ ਸਮਾਂ ਬਾਹਰ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ਾਂ ਨੂੰ ਆਮੰਤ੍ਰਿਤ ਕਰਦਾ ਹੈ। ਪੈਟਰਨ ਹੈ: ਦਸਤਖਤ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ, ਐਨਕਿਊ ਕਰੋ, ਜਵਾਬ ਦਿਓ। ਕਿਊ ਇੱਕ ਕਰਮਚਾਰੀ ਵਿੱਚ ਅਸਲ ਡਿਲਿਵਰੀ ਚਲਾਉਂਦੀ ਹੈ ਜਿਸ ਵਿੱਚ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ਾਂ, ਵਧੀਆ ਵਾਪਸੀ, ਅਤੇ ਆਪਣੀ ਹੀ ਆਈਡੈਂਪੋਟੈਂਸੀ ਹੁੰਦੀ ਹੈ। BullMQ ਅਤੇ Celery ਦੋਹਾਂ ਪ੍ਰਤੀ-ਨੌਕਰੀ ID ਨੂੰ ਸਮਰਥਨ ਕਰਦੇ ਹਨ, ਜੋ ਇੱਕੋ ਹੀ ਇਵੈਂਟ ਦੀ ਦੁਬਾਰਾ ਐਨਕਿਊਇੰਗ ਨੂੰ ਰੋਕਦਾ ਹੈ।

TypeScript (BullMQ)
// Express handler: verify, enqueue, return 200 fast.
import { Queue } from "bullmq";
import { webhooks } from "@blockchain0x/node";

const paymentQueue = new Queue("payments");

app.post(
  "/webhooks/payment",
  express.raw({ type: "application/json" }),
  async (req, res) => {
    const result = webhooks.verify({
      headers: req.headers,
      rawBody: req.body,
      secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
    });
    if (!result.ok) return res.status(400).json({ code: result.code });
    await paymentQueue.add(result.eventType, { raw: req.body.toString() }, {
      jobId: result.eventId,            // Idempotency key.
      removeOnComplete: true,
      attempts: 5,
      backoff: { type: "exponential", delay: 1000 },
    });
    res.status(200).send("ok");
  },
);

// Worker file:
import { Worker } from "bullmq";
new Worker("payments", async (job) => {
  await handleEvent(job.data);
});
Python (Celery)
# Flask handler enqueues to Celery (or arq) and returns 200 quickly.
from celery import Celery
from flask import request

celery = Celery("payments", broker=os.environ["REDIS_URL"])

@celery.task(bind=True, max_retries=5)
def handle_payment_event(self, event_type, raw):
    try:
        process_event_once(event_type, raw)
    except Exception as exc:
        raise self.retry(exc=exc, countdown=2 ** self.request.retries)

@app.post("/webhooks/payment")
def webhook():
    raw = request.get_data()
    if not verify_signature(raw):
        abort(401)
    event_id = request.headers.get("X-Blockchain0x-Event-Id", "")
    event_type = request.headers.get("X-Blockchain0x-Event-Type", "")
    handle_payment_event.apply_async(args=[event_type, raw.decode()], task_id=event_id)
    return "ok", 200

arq ਪਾਇਥਨ ਪਾਸੇ ਉਨ੍ਹਾਂ ਹੀ ਆਕਾਰਾਂ ਦਾ ਪਾਲਣ ਕਰਦਾ ਹੈ - ਕੰਮ ਨੂੰ ਇੱਕ ਨਿਰਧਾਰਿਤ ਨੌਕਰੀ ID ਨਾਲ ਰਜਿਸਟਰ ਕਰੋ ਅਤੇ ਕਤਾਰ ਨੂੰ ਦੁਹਰਾਉਂਦੇ ਕੰਮ ਕਰਨ ਦਿਓ। ਮੁੱਖ ਸੀਮਾ ਇਹ ਹੈ ਕਿ ਕਤਾਰ ਵਿੱਚ ਸ਼ਾਮਲ ਕਰਨਾ ਤੇਜ਼ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ (Redis ਲਈ ਇੱਕ ਇਕੱਲਾ ਗੋਲ ਦੌਰਾ); ਦੂਰ ਦੇ ਕਾਲਾਂ 'ਤੇ ਵੈਬਹੂਕ ਨੂੰ ਕਦੇ ਵੀ ਰੋਕੋ ਨਾ।

ਕਦਮ 4 ਵਿੱਚ 4

ਇੱਕ ਭੁਗਤਾਨ ਸੰਭਾਲੋ ਜੋ ਕਦੇ ਨਹੀਂ ਲੈਂਦਾ।

ਕੋਈ ਫੇਲ੍ਹ ਹੋਣ ਵਾਲਾ ਵੈਬਹੂਕ ਨਹੀਂ ਹੈ - ਜੇ ਖਰੀਦਦਾਰ ਛੱਡਦਾ ਹੈ, ਤਾਂ ਕੋਈ ਘਟਨਾ ਨਹੀਂ ਆਉਂਦੀ, ਅਤੇ ਏਜੰਟ 'ਭੁਗਤਾਨ ਦੀ ਉਡੀਕ' ਵਿੱਚ ਫਸਿਆ ਰਹਿੰਦਾ ਹੈ। ਇਸ ਲਈ ਇਸਨੂੰ ਆਪਣੇ ਆਪ ਪਤਾ ਕਰੋ: ਉਹ ਕੰਮ ਚਲਾਓ ਜੋ ਬਹੁਤ ਲੰਬੇ ਸਮੇਂ ਤੱਕ ਉਡੀਕ ਕਰ ਚੁੱਕੇ ਹਨ, ਚੇਨ ਦੇ ਖਿਲਾਫ transactions.get ਨਾਲ ਮੁੜ ਮਿਲਾਓ ਜੇਕਰ ਇਹ ਵਾਸਤਵ ਵਿੱਚ ਸੈਟਲ ਹੋ ਗਿਆ, ਫਿਰ ਰੱਖੇ ਗਏ ਸਰੋਤਾਂ ਨੂੰ ਛੱਡ ਦਿਓ, ਕੰਮ ਨੂੰ ਇੱਕ ਟਰਮੀਨਲ ਬਿਨਾਂ ਭੁਗਤਾਨ ਦੀ ਸਥਿਤੀ ਵਿੱਚ ਲਿਜਾਓ, ਅਤੇ (ਜੇ ਲੋੜ ਹੋਵੇ) ਨਤੀਜੇ ਨੂੰ ਉਪਭੋਗਤਾ ਨੂੰ ਦਿਖਾਓ।

TypeScript
async function sweepStaleAwaitingPayment() {
  for (const job of await findJobsAwaitingPaymentOlderThan("1h")) {
    // Reconcile against the chain before giving up.
    const tx = job.txHash ? await client.transactions.get(job.txHash) : null;
    if (tx) { markJobPaid(job.id); continue; }   // It actually settled.

    // 1. Release any held resources tied to the job.
    releaseHeldResources(job.id);
    // 2. Move it out of 'awaiting_payment' into a terminal 'unpaid' state.
    markJobUnpaid(job.id);
    // 3. (Optional) Notify the user, with a fresh payment link.
    notifyUser(job.userId, { template: "agent_payment_unpaid", jobId: job.id });
  }
}
Python
# Run on a schedule - there is no failure webhook to wait for.
def sweep_stale_awaiting_payment():
    for job in find_jobs_awaiting_payment_older_than("1h"):
        tx = client.transactions.get(job["tx_hash"]) if job.get("tx_hash") else None
        if tx:
            mark_job_paid(job["id"])   # It actually settled.
            continue

        release_held_resources(job["id"])
        mark_job_unpaid(job["id"])
        notify_user(job["user_id"], template="agent_payment_unpaid", job_id=job["id"])
ਆਮ ਪਿੱਟਫਾਲ

ਪੰਜ ਗਲਤੀਆਂ ਜੋ ਇਵੈਂਟਾਂ ਨੂੰ ਛੱਡ ਜਾਂ ਦੁਹਰਾਉਂਦੀਆਂ ਹਨ।

ਦਸਤਖਤ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਬਾਡੀ ਨੂੰ ਪਾਰਸ ਕਰਨਾ

HMAC ਨੂੰ ਉਹਨਾਂ ਕੱਚੀਆਂ ਬਾਈਟਾਂ 'ਤੇ ਗਣਨਾ ਕੀਤੀ ਜਾਣੀ ਚਾਹੀਦੀ ਹੈ ਜਿਨ੍ਹਾਂ 'ਤੇ ਭੇਜਣ ਵਾਲੇ ਨੇ ਹਸਤਾਖਰ ਕੀਤੇ। ਜੇ ਤੁਹਾਡਾ ਫਰੇਮਵਰਕ ਤੁਹਾਡੇ ਹੈਂਡਲਰ ਚਲਣ ਤੋਂ ਪਹਿਲਾਂ JSON ਨੂੰ ਆਟੋ-ਪਾਰਸ ਕਰਦਾ ਹੈ, ਤਾਂ ਤੁਹਾਡੇ ਦੁਆਰਾ ਸਥਾਨਕ ਤੌਰ 'ਤੇ ਹਸਤਾਖਰ ਕੀਤੀਆਂ ਬਾਈਟਾਂ ਭੇਜਣ ਵਾਲੇ ਦੁਆਰਾ ਹਸਤਾਖਰ ਕੀਤੀਆਂ ਬਾਈਟਾਂ ਨਾਲ ਮਿਲਣਗੀਆਂ ਨਹੀਂ (ਵੱਖਰੇ ਖਾਲੀ ਸਥਾਨ, ਕੁੰਜੀ ਦੀ ਕ੍ਰਮ, ਕੋਡਿੰਗ) ਅਤੇ ਹਰ ਹਸਤਾਖਰ ਗਲਤ ਦਿਖਾਈ ਦੇਵੇਗਾ। ਰੂਟ ਨੂੰ ਕੱਚਾ ਸਰੀਰ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਸੰਰਚਿਤ ਕਰੋ (Express: express.raw, Flask: request.get_data), ਪਹਿਲਾਂ ਪੁਸ਼ਟੀ ਕਰੋ, ਫਿਰ ਪਾਰਸ ਕਰੋ।

Webhook ਹੈਂਡਲਰ ਦੇ ਅੰਦਰ ਅਸਲ ਕੰਮ ਕਰਨਾ

Webhooks ਵਿੱਚ ਆਕਰਸ਼ਕ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਦੀਆਂ ਨੀਤੀਆਂ ਹੁੰਦੀਆਂ ਹਨ। ਜੇ ਤੁਹਾਡਾ ਹੈਂਡਲਰ ਕੰਮ ਨੂੰ ਪਹੁੰਚਾਉਣ ਲਈ 30 ਸਕਿੰਟ ਲੈਂਦਾ ਹੈ, ਤਾਂ ਭੇਜਣ ਵਾਲੇ ਦਾ ਟਾਈਮਆਉਟ ਫਾਇਰ ਹੁੰਦਾ ਹੈ ਅਤੇ ਵੈਬਹੂਕ ਦੁਬਾਰਾ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ - ਹੁਣ ਤੁਹਾਡੇ ਕੋਲ ਇੱਕ ਹੀ ਭੁਗਤਾਨ ਲਈ ਦੋ ਡਿਲਿਵਰੀਆਂ ਹਨ। ਹਮੇਸ਼ਾ: ਪੁਸ਼ਟੀ ਕਰੋ, ਕਤਾਰ ਵਿੱਚ ਰੱਖੋ, 2xx ਵਾਪਸ ਕਰੋ। ਅਸਲ ਕੰਮ ਇੱਕ ਬੈਕਗ੍ਰਾਊਂਡ ਵਰਕਰ ਵਿੱਚ ਚੱਲਦਾ ਹੈ ਜੋ ਜਿੰਨਾ ਲੋੜੀਂਦਾ ਹੈ ਲੰਬਾ ਲੈ ਸਕਦਾ ਹੈ।

ਵਪਾਰਕ ਤਰਕ ਨੂੰ ਸੰਚਾਰਿਤ ਕਰਨ ਲਈ HTTP ਸਥਿਤੀ ਦੀ ਵਰਤੋਂ ਕਰਨਾ

ਜੇ ਤੁਹਾਡਾ ਹੈਂਡਲਰ 4xx ਵਾਪਸ ਕਰਦਾ ਹੈ ਜਦੋਂ ਉਪਭੋਗਤਾ ਤੁਹਾਡੇ ਸਿਸਟਮ ਵਿੱਚ ਹੁਣ ਨਹੀਂ ਹੈ, ਤਾਂ ਭੇਜਣ ਵਾਲਾ ਇਸਨੂੰ 'ਗਲਤ ਬੇਨਤੀ' ਵਜੋਂ ਲੈਂਦਾ ਹੈ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰਨਾ ਰੋਕਦਾ ਹੈ। ਜੇ ਇਹ ਉਸੇ ਸਥਿਤੀ ਲਈ 5xx ਵਾਪਸ ਕਰਦਾ ਹੈ, ਤਾਂ ਭੇਜਣ ਵਾਲਾ ਸਦਾ ਲਈ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡੀ ਕਿਊ ਭਰ ਜਾਂਦੀ ਹੈ। ਜਦੋਂ ਤੁਸੀਂ ਸੁਰੱਖਿਅਤ ਤੌਰ 'ਤੇ ਇਵੈਂਟ ਨੂੰ ਸਥਾਈ ਕੀਤਾ ਹੈ (ਜਾਂ ਇਸਨੂੰ ਇੱਕ ਦੁਹਰਾਈ ਵਜੋਂ ਪਛਾਣਿਆ ਹੈ) ਤਾਂ 200 ਵਾਪਸ ਕਰੋ; ਵਪਾਰਕ ਫੈਸਲੇ ਨੂੰ ਪ੍ਰਗਟ ਕਰਨ ਲਈ ਕਿਊ ਲਾਜਿਕ ਦੀ ਵਰਤੋਂ ਕਰੋ, ਨਾ ਕਿ HTTP ਸਥਿਤੀ।

ਇਵੈਂਟ ID ਦੀ ਬਜਾਏ ਪੇਲੋਡ ਹੈਸ਼ 'ਤੇ ਆਈਡੈਂਪੋਟੈਂਸੀ

ਇੱਕੋ ਏਜੰਟ ਬਾਰੇ ਦੋ ਵੱਖਰੇ ਘਟਨਾਵਾਂ (ਇੱਕ payment.received ਅਤੇ ਇੱਕ ਬਾਅਦ ਵਿੱਚ payment.sent) ਵੱਖਰੇ ਬੋਡੀਜ਼ ਹਨ ਅਤੇ ਵਾਜਬ ਤੌਰ 'ਤੇ ਵੱਖਰੇ ਪ੍ਰਕਿਰਿਆ ਕਰਨ ਦੀ ਲੋੜ ਹੈ। ਜੇ ਤੁਹਾਡਾ ਡਿਡਿਊਪ ਬੋਡੀ ਹੈਸ਼ 'ਤੇ ਹੈ ਤਾਂ ਤੁਸੀਂ ਉਨ੍ਹਾਂ ਵਿੱਚੋਂ ਇੱਕ ਨੂੰ ਛੱਡ ਸਕਦੇ ਹੋ। X-Blockchain0x-Event-Id (ਪ੍ਰਤੀ ਡਿਲਿਵਰੀ ਵਿਲੱਖਣ) 'ਤੇ ਡਿਡਿਊਪ ਕਰੋ, ਅਤੇ ਘਟਨਾ ਦੀ ਕਿਸਮ ਨੂੰ ਤੁਹਾਡੇ ਹੈਂਡਲਰ ਦੇ ਕੀ ਕਰਨ ਦੀ ਦਿਸ਼ਾ ਦਿਓ।

ਇੱਕ ਵੱਖਰੀ ਪੁਸ਼ਟੀ ਇਵੈਂਟ ਦੀ ਉਮੀਦ ਕਰਨਾ

ਸ਼ਿਪ ਕੀਤੇ events ਹਨ payment.received, payment.sent, wallet.deployed, ਅਤੇ webhook.test - ਕੋਈ separate confirmation event ਨਹੀਂ ਹੈ। ਜਦ transfer block ਵਿੱਚ ਆ ਜਾਂਦਾ ਹੈ ਤਾਂ payment.received fire ਹੁੰਦਾ ਹੈ, ਜੋ ਬਹੁਤੇ ਕੰਮਾਂ ਲਈ ਤੁਹਾਡਾ signal ਹੈ। ਕੁਝ ਮਹਿੰਗੇ ਜਾਂ irreversible ਕੰਮ ਲਈ transactions.get ਨਾਲ poll ਕਰੋ ਅਤੇ ਆਪਣਾ confirmation threshold ਲਗਾਓ; ਉਸ event ਦੀ ਉਡੀਕ ਨਾ ਕਰੋ ਜੋ ਮੌਜੂਦ ਹੀ ਨਹੀਂ ਹੈ।

ਅਗਲੇ ਕਦਮ

ਜਦੋਂ ਵੈੱਬਹੂਕ ਬੁਲਟਪ੍ਰੂਫ ਹੁੰਦੇ ਹਨ।

Webhooks ਮੁਸ਼ਕਲ ਹਿੱਸਾ ਹਨ। ਉੱਪਰ ਦਿੱਤੇ ਚਾਰ ਪੈਟਰਨਾਂ ਨਾਲ, ਬਾਕੀ ਦਾ ਕੰਮ ਮੁੱਖ ਤੌਰ 'ਤੇ ਓਪਰੇਸ਼ਨਲ ਹੈ: ਇੱਕ ਟੈਸਟ ਵਾਤਾਵਰਣ ਜੋ ਫੇਲਿਊਰ ਪਾਥਾਂ ਨੂੰ ਅਭਿਆਸ ਕਰਦਾ ਹੈ, ਖਰਚ ਨਿਯੰਤਰਣ ਤਾਂ ਜੋ ਉੱਪਰਲੇ ਏਜੰਟ ਤੁਹਾਡੇ ਹੈਂਡਲਰ ਨੂੰ ਭਰ ਨਾ ਦੇਵੇ, ਅਤੇ ਇੱਕ ਅੰਤਿਮ ਸੁਰੱਖਿਆ ਸਮੀਖਿਆ।

ਪੂਰੀ ਹਵਾਲਾ docs.blockchain0x.com 'ਤੇ ਹੈ। ਵੈਬਹੂਕ ਸ਼ਬਦਕੋਸ਼: payment mandate. ਉਤਪਾਦ ਸਤਹ: Payment API.

ਆਖਰੀ ਸਮੀਖਿਆ: 2026-05-15. CC BY 4.0 ਦੇ ਅਧੀਨ ਪ੍ਰਕਾਸ਼ਿਤ।

Webhooks ਜਿਨ੍ਹਾਂ 'ਤੇ ਤੁਸੀਂ ਭਰਵਾਂ ਹਾਲਤ ਵਿੱਚ ਭਰੋਸਾ ਕਰ ਸਕਦੇ ਹੋ।

ਦਸਤਖਤ ਕੀਤੇ, ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕੀਤੀ, ਆਈਡੇਮਪੋਟੈਂਟ। ਸ਼ੁਰੂ ਕਰਨ ਲਈ ਮੁਫ਼ਤ।