NowgateDocs

Forwarding

Send what arrives on to your own wallet by itself, each payment or once a day.

Forwarding pays what you receive on to one of your destinations without a call per payment. You set one rule per asset with PUT /v1/forwarding, and read them with GET /v1/forwarding; the API reference has every field.

const forwarding = await payouts.forwarding.update({
  rules: [
    { network: "tron", asset: "USDT", destination, mode: "daily", hour: 18, min_amount: "100" },
  ],
});
ModeWhat it forwards
paymentEach payment's credit, as one payout, as soon as it reaches your available balance.
dailyYour whole available balance of the asset, once a day, at hour (UTC).
  • The destination must be active: a new one waits first.
  • Nothing under min_amount is forwarded; it stays in your balance.
  • Forwarding payouts are ordinary payouts, with source: "forwarding": the same statuses, webhooks, limits and fees. The network fee comes out of what is forwarded (fee_paid_by: "payee"), so your balance is left whole.
  • They never wait for approval: you approved the rule when you set it.
  • Each credit is forwarded once, and a daily rule forwards once a day.
  • Setting the rules again replaces them all at once; an empty list stops forwarding. A rule kept for an asset keeps its first time, so it doesn't forward again what came before it.