Getting started

Autlantic Payments verifies USDT (TRC-20) on TRON for merchant checkouts. Funds go to your Tron wallet; the SDK does not custody revenue.

Install

npm install @autlantic/payments

Published packages:

• @autlantic/payments — main client (recommended)
• @autlantic/payments-core — types and pure verify
• @autlantic/chain-tron — TronGrid adapter

Requires Node.js 20+.

Quickstart

import { AutlanticPayments } from "@autlantic/payments";

const payments = new AutlanticPayments({
  tronGridApiKey: process.env.TRONGRID_API_KEY,
});

const intent = payments.createIntent({
  merchantRef: order.id,
  amountUsdt: 20,
  payToAddress: creator.payoutAddressTron,
  matchStrategy: "minimum_amount",
  expiresAt: new Date(Date.now() + 60 * 60 * 1000),
});

// Member pasted tx hash
const result = await payments.verifyByTxHash(intent, txHashFromUser);
if (result.ok) {
  await markOrderPaid(order.id, result.transfer.txHash);
}

// Or poll recent incoming USDT to the payout address
const match = await payments.findMatchingPayment(intent);

Environment variables

Variable	Purpose
TRONGRID_API_KEY	Live verify / poll (from TronGrid)
AUTLANTIC_PAYMENTS_SANDBOX	true / 1 / yes for test mode (no TronGrid)
AUTLANTIC_PAYMENTS_WEBHOOK_SECRET	Sign outbound payment.confirmed webhooks
AUTLANTIC_PAYMENTS_POLL_LIMIT	Max rows when polling incoming transfers

const payments = AutlanticPayments.fromEnv();

Match strategies

Strategy	Use case
minimum_amount	Plan price (e.g. 20 USDT); overpay OK
exact_amount	Micro-unit exact match (legacy)

Hosted API alternative

If you prefer HTTP + API key over embedding Node, see Hosted HTTP API.

Next steps

• Sandbox & testing — test tx hashes, emitTestEvent
• Webhooks — sign and verify payment.confirmed
• Node.js API reference — full method list
• Security — production checklist