Invoice / Payment Request

An invoice (or payment request) in crypto payments is a structured request containing all information needed for a customer to complete a payment.

Invoice Components

FieldDescriptionExample

|-------|-------------|---------|

IDUnique identifierpay_abc123 AmountPayment amount50.00 USDT AddressDeposit addressTQn9Y... ExpirationDeadline30 minutes StatusCurrent statePENDING QR CodeScannable address(image)

Invoice Lifecycle

CREATED → PENDING → CONFIRMED/EXPIRED/CANCELED

Created: Invoice generated with unique address

Pending: Awaiting customer payment

Confirmed: Payment received and verified

Expired: Deadline passed without payment

Canceled: Manually canceled by merchant

Creating an Invoice via API

POST /api/v1/payment/create
{
  "amount": 50.00,
  "currency": "USDT",
  "external_id": "order_123"
}

Response:

{
  "id": "pay_abc123",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "expires_at": "2025-01-15T10:30:00Z"
}

Best Practices

Unique addresses: Each invoice gets a fresh address

Clear expiration: Show countdown to customer

Amount precision: Show exact amount required

Network clarity: Specify TRC-20 for USDT

Related Terms

Crypto Payment Gateway

Settlement

Webhooks

Learn More

Crypto Checkout Flow

API Reference