Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iterapay.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Invoices are the foundation of payment collection on IteraPay. You create an invoice, share it with your customer, and IteraPay generates a crypto payment address for them to send funds to. This guide walks you through the full flow — from creating your first invoice to confirming that payment was received.

​
Prerequisites

Before you start, make sure you have:
  • A merchant account with your merchantID
  • A valid API key or JWT bearer token
  • The ID of the payment method you want to accept (e.g., USDT on TRON)

​
Create a one-time invoice

A onetime invoice accepts a single payment. Use this for individual orders or transactions.
1

Create the invoice

Send a POST request to create the invoice. Provide the amount in USD, a description, and set the type to onetime.
curl --request POST \
  --url https://api.iterapay.com/merchants/{merchantID}/invoices \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 100,
    "type": "onetime",
    "description": "Order #1042 - Premium Plan"
  }'
Expected response:
{
  "id": "inv_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "amount": 100,
  "type": "onetime",
  "description": "Order #1042 - Premium Plan",
  "status": "pending",
  "createdAt": "2024-01-01T10:00:00Z"
}
Save the id — you’ll use it in the next steps.
2

Retrieve the payment address for a crypto method

Use the public endpoint to get a payment address for a specific payment method. This endpoint requires no authentication, so you can call it from your frontend or redirect your customer to it.
curl --request GET \
  --url https://api.iterapay.com/public/invoices/{invoiceID}/method/{methodID}/address
Expected response:
{
  "address": "TRX9xKqP2mNvLwXbY3zJdR7oU5cH1sA4fE",
  "amount": "100.500000",
  "expiresAt": "2024-01-01T12:00:00Z"
}
Payment addresses expire. Present the expiresAt timestamp to your customer so they know how long they have to complete the payment.
3

Share the invoice with your customer

Send your customer the payment address and the exact crypto amount. You can also share the public invoice URL so they can view it directly:
curl --request GET \
  --url https://api.iterapay.com/public/invoices/{invoiceID}
This endpoint requires no authentication and returns the full invoice details — safe to link to from your checkout page or email.

​
List all payment addresses for an invoice

If your invoice supports multiple payment methods, retrieve all available addresses at once: 
curl --request GET \
  --url https://api.iterapay.com/public/invoices/{invoiceID}/addresses
Expected response: 
[
  {
    "methodID": "method_usdt_tron",
    "address": "TRX9xKqP2mNvLwXbY3zJdR7oU5cH1sA4fE",
    "amount": "100.500000",
    "expiresAt": "2024-01-01T12:00:00Z"
  },
  {
    "methodID": "method_usdc_eth",
    "address": "0x4bF6bC3D1e2a0F9c5d7E8A3b2C1D0e9F8A7B6C5",
    "amount": "100.500000",
    "expiresAt": "2024-01-01T12:00:00Z"
  }
]
Present these options to your customer and let them choose their preferred network.

​
Create a reusable invoice

A reusable invoice accepts multiple payments over time — useful for payment links, donation pages, or any scenario where more than one customer may pay. 
curl --request POST \
  --url https://api.iterapay.com/merchants/{merchantID}/invoices \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 50,
    "type": "reusable",
    "description": "Monthly subscription payment"
  }'
  • Accepts a single payment
  • Expires after the first successful payment
  • Best for individual orders and transactions
Reusable invoices generate a new payment address each time a customer requests one, ensuring that payments are tracked individually even though they share the same invoice.

​
Next steps

Once your customer sends payment, the funds appear as collectible. See Collect Funds to learn how to sweep paid invoice funds into your merchant balance.