Webhook and API guide

Let your website know about each payment, or read the list as JSON. You get the webhook secret and the API key after you connect your wallet on the home page.

Webhook: Payping calls your site

For each payment received, Payping sends one POST with a JSON body to the address you saved. Answer with any 2xx status within 5 seconds.

{
  "event": "payment.received",
  "id": 1042,
  "wallet": "2z4c…Vg8u",
  "amount": "25",
  "symbol": "USDC",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "usd": 25,
  "from": "7xKp…3mQe",
  "signature": "5Uf…",
  "received_at": "2026-11-16T15:04:05.000Z",
  "explorer": "https://solscan.io/tx/5Uf…"
}

mint is SOL for native SOL. usd is the value at the moment of the alert, or null when the token has no reliable price. from can be null. Test calls use "event": "payment.test".

A call is sent once. If your site is down the call is not repeated, so use id with the API below to catch up, and ignore an id you already handled.

Check the signature

Every call has the header x-payping-signature: the HMAC-SHA256, in hex, of the raw body, made with your signing secret. Compute the same value and compare before you trust the call.

import crypto from 'node:crypto';

function isFromPayping(rawBody, header, secret) {
  const mine = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  return header.length === mine.length &&
    crypto.timingSafeEqual(Buffer.from(header), Buffer.from(mine));
}

For anything valuable, also confirm the transaction signature on the blockchain before you ship goods.

API: read your payments

GEThttps://payping.hucori.app/v1/events?key=YOUR_KEY

Returns up to 100 payments, newest first. Add &after=1042 to get only payments with a higher id. Open to any website (CORS), but keep the key on your server: whoever has it can read your payment list.

{
  "wallet": "2z4c…Vg8u",
  "plan": "free",
  "events": [
    { "id": 1042, "signature": "5Uf…", "symbol": "USDC", "mint": "EPjF…Dt1v",
      "amount": "25", "usd": 25, "from": "7xKp…3mQe", "time": 1794841445000 }
  ]
}

On the Free plan a payment appears 15 minutes after it lands. On Pro it appears within seconds.