API Reference

Authentication

Pass your API key in the x-api-key request header on every call.

curl -X POST https://paynovax.online/api/v1/payment/create \
  -H "x-api-key: cpk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"tokenId":1,"amount":"49.99"}'

Generate an ephemeral BSC wallet and QR code for your customer to send tokens to. The platform monitors the wallet and forwards received tokens to your merchant wallet automatically.

Creates a new payment session. Returns a deposit wallet address and QR code for the customer.

Request Body

{
  "tokenId": 1,
  "amount": "49.99"
}

{
  "success": true,
  "data": {
    "sessionId": "ps_abc123",
    "depositAddress": "0xABC...",
    "amount": "49.99",
    "token": "USDT",
    "qrCode": "data:image/png;base64,...",
    "expiresAt": "2026-03-23T12:30:00Z",
    "status": "pending"
  }
}

Poll this endpoint to track payment progress. Poll every 5–10 seconds until status is completed or expired.

{
  "success": true,
  "data": {
    "sessionId":      "ps_abc123",
    "status":         "pending" | "completed" | "expired" | "cancelled",
    "amount":         "49.99",
    "receivedAmount":  "49.99" | null,
    "token":          "USDT",
    "depositAddress":  "0xABC...",
    "txHash":         "0xDEF..." | null,
    "expiresAt":      "2026-03-23T12:30:00Z"
  }
}

Cancels a pending payment session. Has no effect on sessions that are already completed or expired.

{ "success": true, "data": { "message": "Payment session cancelled." } }

Returns a paginated list of payment sessions for the API key.

Query Parameters

{
  "success": true,
  "data": {
    "items": [ /* session objects */ ],
    "meta": { "page": 1, "limit": 20, "total": 143, "pages": 8 }
  }
}

Send BEP-20 tokens or native BNB out from a domain's withdrawal wallet to any BSC address. The withdrawal wallet is configured per domain in your dashboard.

Sends BEP-20 tokens from the domain withdrawal wallet to a recipient address on BSC.

Request Body

{
  "domainId":  3,
  "tokenId":   1,
  "toAddress": "0xRecipient...",
  "amount":    "100.00"
}

{
  "success": true,
  "data": {
    "withdrawalId": "wd_xyz789",
    "txHash":       "0xDEF...",
    "amount":       "100.00",
    "token":        "USDT",
    "toAddress":    "0xRecipient...",
    "status":       "submitted"
  }
}

Returns a paginated list of withdrawal records for the API key. Same page / limit / status query params as the deposit history endpoint.

Error Codes

All errors follow the same envelope: {"success":false,"error":{"code":"...","message":"..."}}