For developers

One call in. One webhook back.

Your team shouldn't need to learn anything about how the money moves. Request a payment, listen for the confirmation, get on with your roadmap.

1 · Request a payment

POST /api/public/xp/v1/invoices
Content-Type: application/json
Authorization: Bearer <your key>

{
  "amount": 500,
  "currency": "USDT",
  "network": "tron",
  "clientId": "trader_8412",
  "orderId": "order_1001"
}

2 · Get a link back

{
  "success": true,
  "invoiceId": "0f6b...c21",
  "code": "Ab12Cd34",
  "payUrl": "https://payments.flowwpay.trade/pay/Ab12Cd34",
  "depositAddress": "TXk...9fA",
  "status": "pending",
  "expiresAt": "2026-07-27T12:30:00Z"
}

3 · We tell you when it's paid

POST https://your-app.com/hooks/flowwpay
X-FlowwPay-Event: invoice.completed
X-FlowwPay-Signature: <hex hmac-sha256>

{
  "event": "invoice.completed",
  "data": {
    "invoiceId": "0f6b...c21",
    "orderId": "order_1001",
    "clientId": "trader_8412",
    "amount": 500,
    "amountReceived": 500,
    "fee": 2.5,
    "net": 497.5,
    "status": "completed"
  }
}

Details that matter

Built by people who've been on call.

Hosted checkout

Redirect to the hosted payment page, or display the returned address in your own interface.

Signed webhooks

HMAC-SHA256 on every delivery, with retries and a full delivery log you can inspect.

Deposit verification

Incoming notifications are checked against the live on-chain USDT balance before crediting.

Idempotency

Use orderId for invoices and referenceId for payouts. Safe retries return the original record.

Stable payloads

Additive changes only. We don't rename fields under you.

Support that codes

Talk to the people who built it, not a ticket queue.

Want the full reference?

Review every endpoint, response, webhook event, signature example, and ready-to-import Postman collection.