Sign in
Introduction/General Information

General Information

Technical specification for cryptocurrency payment processing and withdrawal integration with 2328.io.

View as Markdown·llms.txt

Welcome to the 2328.io API documentation. This reference describes how to integrate cryptocurrency payment processing and withdrawals into your application.

Getting started

To begin integrating:

  1. Create a merchant account and project at 2328.io
  2. Obtain your project UUID and API key from project settings
  3. Generate a separate Payout API key if you plan to use withdrawals
  4. Read the Authentication section to learn how to sign requests
  5. Make your first Create Payment call

Base URL

All production API requests use the following base URL:

Text
https://api.2328.io/api

All requests must be made over HTTPS. Requests without HTTPS are blocked.

What you can do

With the 2328.io API you can:

  • Accept crypto payments — create payment sessions and redirect customers to a hosted checkout or Telegram MiniApp
  • Withdraw funds — programmatically send payouts from your merchant balance to any blockchain address
  • Check balances — see merchant account balances per currency, USD equivalents, and AML-locked amounts
  • Use static wallets — generate permanent deposit addresses tied to a user or order
  • Fetch exchange rates — get real-time rates for fiat and crypto pairs
  • Receive webhooks — get notified instantly when a payment status changes

Rate limits

The API allows up to 10 requests per second per project. Requests above the limit get an HTTP 429 Too Many Requests response — back off and retry.