# IteraPay

## Docs

- [Account Registration (Sign Up)](https://docs.iterapay.com/docs/account-registration-sign-up.md)
- [POST /key/generate/{merchantID} — Generate API key](https://docs.iterapay.com/docs/api-reference/api-keys/generate.md): Generate a new API key for a merchant. Issuing a new key immediately invalidates the existing one. Requires Bearer token authentication.
- [GET /key/info/{merchantID} — Get API key info](https://docs.iterapay.com/docs/api-reference/api-keys/info.md): Retrieve metadata about a merchant's active API key, including when it was created, last used, and its key prefix for identification.
- [DELETE /key/revoke/{merchantID} — Revoke API key](https://docs.iterapay.com/docs/api-reference/api-keys/revoke.md): Permanently revoke a merchant's active API key. The key is immediately invalidated and any requests using it will be rejected.
- [API Error Handling and Error Codes Reference](https://docs.iterapay.com/docs/api-reference/errors.md): IteraPay errors follow RFC 7807. Learn the error response shape, all status codes, and how to handle errors reliably in your integration.
- [POST /merchants/{merchantID}/invoices/{invoiceID} — Archive](https://docs.iterapay.com/docs/api-reference/invoices/archive.md): Mark an invoice as archived to remove it from default listings without deleting it. Archived invoices are still retrievable via the list endpoint.
- [POST /merchants/{merchantID}/invoices — Create invoice](https://docs.iterapay.com/docs/api-reference/invoices/create.md): Create a new invoice under a merchant account. Specify the type, payment method, and USD amount to generate a payment address for your customer.
- [DELETE /merchants/{merchantID}/invoices/{invoiceID}](https://docs.iterapay.com/docs/api-reference/invoices/delete.md): Permanently delete an invoice and its associated data. This action is irreversible — consider archiving instead if you want to preserve the record.
- [GET /merchants/{merchantID}/invoices/{invoiceID}](https://docs.iterapay.com/docs/api-reference/invoices/get.md): Retrieve a single invoice by UUID via authenticated or public endpoint. Both return the same invoice schema including state and AML status.
- [GET /merchants/{merchantID}/invoices — List invoices](https://docs.iterapay.com/docs/api-reference/invoices/list.md): Retrieve a paginated list of invoices for a merchant. Filter by type, state, amount, date range, token, AML status, and more.
- [Get payment address and info for an invoice](https://docs.iterapay.com/docs/api-reference/invoices/payment-info.md): Retrieve the blockchain payment address, expected amount, and expiry for a specific invoice and payment method.
- [POST /ipAddress/{merchantID} — Set IP address restriction](https://docs.iterapay.com/docs/api-reference/ip-addresses/create.md): Create or update the IP address whitelist for a merchant. Only requests originating from the configured IP will be accepted when using API key authentication.
- [DELETE /ipAddress/{merchantID} — Remove IP address restriction](https://docs.iterapay.com/docs/api-reference/ip-addresses/delete.md): Delete the IP address restriction for a merchant. After deletion, API key requests from any IP address will be accepted without an IP-based check.
- [GET /ipAddress/{merchantID} — Get IP address configuration](https://docs.iterapay.com/docs/api-reference/ip-addresses/get.md): Retrieve the IP address restriction currently configured for a merchant. Use this to verify which IP is allowlisted for API key authentication.
- [Create Merchant — POST /merchants](https://docs.iterapay.com/docs/api-reference/merchants/create.md): Create a new merchant account under your organization. Returns the new merchant's UUID on success. Requires Bearer token authentication.
- [Delete Merchant — DELETE /merchants/{merchantID}](https://docs.iterapay.com/docs/api-reference/merchants/delete.md): Permanently delete a merchant by its UUID. This action cannot be undone. Returns 204 No Content on success with no response body.
- [Get Merchant Fees — GET /merchants/{merchantID}/fees](https://docs.iterapay.com/docs/api-reference/merchants/fees.md): Retrieve fee structures and token-amount fee calculations for a merchant by invoice type and payment method. Includes two endpoints for rate and amount queries.
- [Get Merchant Funds — GET /merchants/{merchantID}/funds](https://docs.iterapay.com/docs/api-reference/merchants/funds.md): Retrieve a merchant's available fund balances broken down by payment method. Each entry includes the balance amount and token symbol.
- [Get Merchant — GET /merchants/{merchantID}](https://docs.iterapay.com/docs/api-reference/merchants/get.md): Retrieve a single merchant by its UUID, including its name, settings, and configuration. Supports Bearer token and API key authentication.
- [Get Merchant Limits — GET /merchants/{merchantID}/limits](https://docs.iterapay.com/docs/api-reference/merchants/limits.md): Retrieve the minimum transaction limits for collect and withdrawal operations for a merchant. Requires Bearer token authentication.
- [List Merchants — GET /merchants](https://docs.iterapay.com/docs/api-reference/merchants/list.md): Retrieve all merchants your credentials have access to, including each merchant's current balances across supported payment methods.
- [Update Merchant — PUT /merchants/{merchantID}](https://docs.iterapay.com/docs/api-reference/merchants/update.md): Update a merchant's name or settings by its UUID. Sends a full replacement of updatable fields. Returns the merchant's UUID on success.
- [IteraPay REST API Overview and Reference](https://docs.iterapay.com/docs/api-reference/overview.md): Everything you need to start integrating with the IteraPay API: base URL, authentication, request and response formats, pagination, and rate limits.
- [GET /merchants/{merchantID}/transactions/{transactionID}](https://docs.iterapay.com/docs/api-reference/transactions/get.md): Fetch full details for a specific transaction by UUID, including amount, state, confirmation timestamp, and on-chain transaction hash.
- [POST /merchants/{merchantID}/transactions/list](https://docs.iterapay.com/docs/api-reference/transactions/list.md): Query and filter transactions for a merchant using state, date range, token IDs, and invoice IDs. Returns a paginated list of transaction records.
- [POST /weebhook/{merchantID} — Create or update webhook](https://docs.iterapay.com/docs/api-reference/webhooks/create.md): Register or replace a webhook endpoint for a merchant. Returns a signing token to use when verifying incoming webhook payloads from IteraPay.
- [DELETE /weebhook/{merchantID} — Delete webhook](https://docs.iterapay.com/docs/api-reference/webhooks/delete.md): Remove the webhook configuration for a merchant. IteraPay will stop sending event notifications immediately after the webhook is deleted.
- [GET /weebhook/{merchantID} — Get webhook configuration](https://docs.iterapay.com/docs/api-reference/webhooks/get.md): Retrieve the current webhook URL and creation timestamp for a merchant. Use this to verify your webhook endpoint is registered correctly.
- [POST /merchants/{merchantID}/withdrawals — Create](https://docs.iterapay.com/docs/api-reference/withdrawals/create.md): Create a withdrawal order to send funds from your merchant balance to an external on-chain address. Specify destination address, amount, and payment method.
- [GET /merchants/{merchantID}/withdrawals/{withdrawalID}](https://docs.iterapay.com/docs/api-reference/withdrawals/get.md): Retrieve the details of a specific withdrawal order by ID, including its current state and on-chain transaction hash if available.
- [GET /merchants/{merchantID}/withdrawals/pending](https://docs.iterapay.com/docs/api-reference/withdrawals/pending.md): List all pending withdrawal orders for a merchant. Use this to monitor unconfirmed withdrawals awaiting network submission or on-chain confirmation.
- [Invoices: Requesting and Collecting Payments](https://docs.iterapay.com/docs/concepts/invoices.md): Invoices are how IteraPay generates blockchain deposit addresses for customers. Learn the four invoice types and how the payment lifecycle works.
- [Merchants: Your IteraPay Account Structure](https://docs.iterapay.com/docs/concepts/merchants.md): A merchant is the top-level account in IteraPay. It holds your crypto balances, fee configuration, transaction limits, and team members.
- [Payment Methods: Supported Cryptocurrencies](https://docs.iterapay.com/docs/concepts/payment-methods.md): Payment methods are the cryptocurrencies IteraPay supports. Each has an integer ID you supply when creating invoices and retrieving deposit addresses.
- [Transactions: On-Chain Payment Events Explained](https://docs.iterapay.com/docs/concepts/transactions.md): Transactions record on-chain payment events against your invoices. Learn about transaction states, how they relate to invoices, and how to search them.
- [Creating Invoice](https://docs.iterapay.com/docs/creating-invoice.md)
- [Creating the First Merchant](https://docs.iterapay.com/docs/creating-the-first-merchant.md)
- [Edit Merchant](https://docs.iterapay.com/docs/edit-merchant.md)
- [Fund Collection (Collect): Consolidation](https://docs.iterapay.com/docs/fund-collection-collect-consolidation.md)
- [Funds Management](https://docs.iterapay.com/docs/funds-management.md)
- [Generate API Token](https://docs.iterapay.com/docs/generate-api-token.md)
- [Accept Crypto Payments with Invoices](https://docs.iterapay.com/docs/guides/accept-payments.md): Learn how to create invoices, retrieve payment addresses, and start accepting crypto payments from your customers on IteraPay.
- [Collect Funds from Paid Invoices](https://docs.iterapay.com/docs/guides/collect-funds.md): Learn how to sweep paid invoice funds into your merchant balance by previewing fees, initializing collection, and monitoring collection status.
- [Set Up Webhooks for Payment Notifications](https://docs.iterapay.com/docs/guides/webhooks.md): Learn how to register a webhook endpoint, verify payload signatures, and handle real-time payment event notifications from IteraPay.
- [Withdraw Funds to an External Wallet](https://docs.iterapay.com/docs/guides/withdrawals.md): Learn how to check your available balance, review limits and fees, create a withdrawal order, and track its status on IteraPay.
- [IteraPay: Crypto Payment Processing for Merchants](https://docs.iterapay.com/docs/introduction.md): Accept, collect, and withdraw cryptocurrency payments through a single REST API. IteraPay handles blockchain complexity so you can focus on your business.
- [Invoice Details](https://docs.iterapay.com/docs/invoice-details.md)
- [Invoice List](https://docs.iterapay.com/docs/invoice-list.md)
- [IP Whitelisting](https://docs.iterapay.com/docs/ip-whitelisting.md)
- [One-time invoice](https://docs.iterapay.com/docs/one-time-invoice.md)
- [Overview](https://docs.iterapay.com/docs/overview.md)
- [Password Recovery (Reset Password)](https://docs.iterapay.com/docs/password-recovery-reset-password.md)
- [Revoke API Token](https://docs.iterapay.com/docs/revoke-api-token.md)
- [Static Invoice (reusable)](https://docs.iterapay.com/docs/static-invoice-rusable.md)
- [System Login (Login)](https://docs.iterapay.com/docs/system-login-login.md)
- [Transaction History (Transactions)](https://docs.iterapay.com/docs/transaction-history-transactions.md)
- [Webhooks](https://docs.iterapay.com/docs/untitled-page.md)
- [Withdrawal of funds (Withdraw)](https://docs.iterapay.com/docs/withdrawal-of-funds-withdraw.md)