/API
Widget Docs

Getting Started

Core Resources

Getting Started

Back to API Overview

This guide will help you get started with integrating the Two-Coin payment system into your application. Follow these steps to begin accepting cryptocurrency payments through our platform.

Registration Process

To use the Two-Coin API, you need to register as a merchant and obtain your API credentials.

  1. 1. Contact our team to create a merchant account
  2. 2. Complete the verification process
  3. 3. Receive your API key and merchant ID
  4. 4. Configure your webhook endpoint

Authentication Setup

All API requests must be authenticated using HMAC authentication. See the Authentication section for detailed instructions.

Basic Integration Flow

Here's the typical flow for accepting payments with Two-Coin:

⚠️ Important First Step:

Always fetch the currency dictionary first: GET /api/dict/currencies. All API endpoints use integer currency IDs, not tickers (e.g., use 35 for USD, not "USD").

  1. 0. Fetch Currency Dictionary - Cache all currencies with their integer IDs for use in subsequent calls
  2. 1. Get Available Countries - Show supported countries to user
  3. 2. Fetch Currency Pairs - Get available fiat→crypto combinations for the selected country
  4. 3. Get Payment Methods - Show available payment options for the selected fiat currency
  5. 4. Request Offers - Get quotes from providers for the selected currency pair and amount
  6. 5. Create an Order - Create an order with the chosen provider and payment method
  7. 6. Receive Webhooks - Listen for order status updates via webhooks

New to the currency ID system? Check out the Complete Integration Flow guide for step-by-step examples with real API calls.

Next Steps

Authentication →Working with Orders →Webhook Setup →

Support

If you encounter any issues or have questions not addressed in this documentation, please contact our support team on Telegram at https://t.me/cs_2coin (@cs_2coin).