Developer Integration Reference

curl --request POST \
  --url https://payxmint.com/api/v1/check-status \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "order_id": "pay_202506038627"
  }'

{
  "id": "ptx_8f2a9c3d1e",
  "object": "payment_intent",
  "amount": 1850.00,
  "currency": "INR",
  "status": "SUCCESS",
  "order_id": "tx_873491023",
  "metadata": {},
  "payer": {
    "name": "John Doe",
    "upi": "johndoe@ybl"
  },
  "settlement": {
    "utr": "6120948375",
    "txn_id": "tx_612093847",
    "timestamp": "2026-05-19T17:11:45.000Z"
  },
  "created": 1779187312,
  "expire_at": 1779188212
}

const crypto = require('crypto');

// 1. Webhook Secret from your PayxMint Dashboard
const webhookSecret = process.env.PAYXMINT_WEBHOOK_SECRET;

function handleIncomingWebhook(req, res) {
  const signature = req.headers['x-payxmint-signature'];
  const rawBody = req.rawBody; // Ensure raw unparsed string body

  // 2. Validate HMAC-SHA256 signature
  const expectedSignature = crypto
    .createHmac('sha256', webhookSecret)
    .update(rawBody)
    .digest('hex');

  if (signature !== expectedSignature) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  const payload = JSON.parse(rawBody);
  const { order_id, amount, utr } = payload;

  // 3. IDEMPOTENCY SAFETY NET: Check if order was already processed
  const order = await db.orders.findOne({ order_id });
  if (!order || order.status === 'SUCCESS') {
    // Already credited or processed! Acknowledge with 200 OK and EXIT safely.
    return res.status(200).json({ status: 'already_processed' });
  }

  // 4. Atomic Credit within Database Transaction
  await db.transaction(async (tx) => {
    await tx.orders.update({ where: { order_id }, data: { status: 'SUCCESS', utr } });
    await tx.wallets.increment({ where: { userId: order.userId }, data: { balance: amount } });
  });

  return res.status(200).json({ status: 'success' });
}

{
  "event": "payment.success",
  "status": "SUCCESS",
  "order_id": "pay_202506038627",
  "amount": 620.00,
  "utr": "7019283745",
  "payer_name": "John Doe",
  "payer_upi": "johndoe@ybl",
  "metadata": {},
  "timestamp": "2026-05-19T17:11:45.000Z"
}

curl --request GET \
  --url 'https://payxmint.com/api/v1/events?limit=10&offset=0' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "object": "list",
  "url": "/v1/events",
  "has_more": false,
  "data": [
    {
      "id": "evt_8f1a2b3c4d",
      "object": "event",
      "type": "payment.success",
      "created": 1779187320,
      "data": {
        "event": "payment.success",
        "order_id": "pay_202506038627",
        "amount": 5000.00,
        "utr": "7019283745"
      },
      "status": "DELIVERED",
      "retry_count": 0,
      "next_retry": null
    }
  ]
}