Skip to content

Payment Result Verification ​

How to verify payment information from Webhook events.

Step 1: Verify HMAC Signature ​

If you have configured a webhook signing secret, verify the X-SoloPay-Signature header before processing the payload. See the Webhook Guide for details.

Step 2: Verify Payment via API ​

Use the paymentId in the Webhook payload to call the SoloPay API directly from your server and confirm the payment status.

Always Verify from the Server

Do not trust Webhook payload contents directly. Always re-confirm the actual payment status via the API.

bash
curl https://gateway.dev.solonetwork.io/api/v1/payments/0xabc123... \
  -H "x-public-key: pk_xxxxx"

Verification Checklist

Idempotency ​

The same event may be sent multiple times. Use paymentId to prevent duplicate processing.

typescript
// Check if this paymentId was already processed (DB lookup)
const alreadyProcessed = await db.orders.isPaymentProcessed(data.paymentId);
if (alreadyProcessed) {
  return res.status(200).json({ received: true }); // Ignore duplicate event
}

Next Steps ​

Non-custodial Web3 payment infrastructure for ERC-20 checkout, sponsored gas, and wallet-to-wallet settlement.