Getting Started

Accept credit & debit card and cryptocurrency (Bitcoin, Ethereum, USDT TRC20 and every major coin) on your own website with a single integration. Cryptorch hosts the secure checkout for you: make one API call from your server, send your customer to the payment page we return, and we notify your server the instant the payment is confirmed.

Integrate in 5 steps

  1. Complete your company profile — Dashboard → Company Profile (business name, logo, email, address). Required before the API accepts requests.
  2. Get your API credentials — Dashboard → Developer → API Credentials. Copy your client-id and client-secret.
  3. Whitelist your server IP — Dashboard → Developer → IP Whitelist. Add the public IP of the server that will call the API (requests from other IPs are rejected).
  4. Create a payment — from your server, POST to https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/payment-initiate with the amount and your callback URLs (see Create Invoice). You receive a payment_link.
  5. Send your customer to the checkout — redirect (or embed) the payment_link. Your customer picks card or any coin and pays. When done, we POST a confirmation to your ipn_url (see Payment Notification) and return them to your success_url.

Card and crypto are offered on the same hosted page — no separate integrations needed. Use the unique merchant_trx you send to match each payment back to the order in your system.

Introduction

The Cryptorch API follows RESTful architecture standards, offering clear and consistent resource-based endpoints. All requests and responses are transmitted in JSON format, leveraging standard HTTP verbs, status codes, and authentication protocols to enable secure, efficient, and scalable integrations.

API Base URL

Please note that Cryptorch does not provide a sandbox or test environment. All API requests are processed in the live environment, so ensure that all request data and parameters are accurate before making any calls.

string 
https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api

Authentication

All requests to the Cryptorch API require authentication. Each API request must include a valid client-id and client-secret to the request header, which can be obtained from your Cryptorch Dashboard under Developer Tools.

In addition to credentials, Cryptorch enforces IP-based security. You must register and enable your server’s public IP address in the IP Whitelist section of the dashboard. Requests originating from non-whitelisted IP addresses will be automatically rejected.

Both valid API credentials and an approved IP address are mandatory. Without completing these two steps, authentication will fail and API access will not be granted.

Response Format

All responses from the Cryptorch API are returned in JSON format. Each response follows a consistent structure and includes a status indicator, message, and relevant data payload when applicable. Standard HTTP status codes are used to represent the outcome of each request.

Sample Success Response

JSON 
{
"status": "success",
"remark": "invoice_created",
"message":[
    "Invoice created successfully"
],
"data": {
   ...you get all data here
    }
}

Error Sample Response

JSON 
{
    "remark": "Unauthorized",
    "status": "error",
    "message": [
        "The client secret is required"
    ]
}
JSON 
 {
    "remark": "Unauthorized",
    "status": "error",
    "message": [
        "Access to this API endpoint is restricted to IP addresses that have been explicitly whitelisted.",
        "In order to access this API endpoint, please add your IP address (::1) to the white list from the user dashboard."
    ]
}

Payment Notification (IPN)

When a payment is completed, Cryptorch sends a server-to-server POST to the ipn_url you supplied when creating the payment. Use it to mark the order paid and release your product or credit. Respond with HTTP 200 to acknowledge, and match the payment to your order using the merchant_trx you sent.

For safety, always re-confirm the status by also calling Invoice Status before fulfilling — never rely on the notification alone.

Notification payload (POST body)

JSON
{
    "status": "success",
    "payment_status": "success",
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Payment processed successfully",
    "data": {
        "invoice_id": "579837695117067",
        "trx": "ABC123XYZ",
        "merchant_trx": "TX123456",
        "order_id": "9876",
        "payment": { "amount": "199.72", "charge": "0", "method": "Crypto Payment" },
        "currency": { "code": "USDTTRC20", "name": "Tether TRC20" },
        "date": "2026-08-12 18:00:00"
    }
}
php 

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/invoice-list',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'client-id: YOUR-CLIENT-ID',
    'client-secret: YOUR-CLIENT-SECRET',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Get Invoice List

This endpoint allows you to retrieve a complete list of invoices associated with your Cryptorch account. Each invoice includes a status and a type. Please refer to the definitions below:

Invoice Status:
Unpaid = 0
Paid = 1
Partially Paid = 2
Expired = 9

Invoice Type:
Crypto Invoice = 1
Fiat Invoice = 0

GET
invoice-list
Query Parameters

Query parameters that allow you to customize the API response.

Name Description Required Default
page Specifies the page number to retrieve. No 1
paginate Defines the number of items returned per page. No 20
search Search by invoice ID. No -
php 

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/invoice-details/:invoice_id',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'client-id: YOUR-CLIENT-ID',
    'client-secret: YOUR-CLIENT-SECRET',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Invoice Detail

This endpoint allows you to retrieve a invoice & related payments associated with your Cryptorch account.

GET
invoice-details/{invoice_id}
php 

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/invoice-status/:invoice_id',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'client-id: YOUR-CLIENT-ID',
    'client-secret: YOUR-CLIENT-SECRET',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Invoice Payment Status

This endpoint allows you to retrieve a invoice status associated with your Cryptorch account.

GET
invoice-status/{invoice_id}
php 

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/payment-list',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'client-id: YOUR-CLIENT-ID',
    'client-secret: YOUR-CLIENT-SECRET',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Get Payment List

This endpoint allows you to retrieve a complete list of payments associated with your Cryptorch account and with invoice. Each payments includes a status. Please refer to the definitions below:

Invoice Status:
Success = 1
Failed = 3
Initiated = 0

GET
payment-list
Query Parameters

Query parameters that allow you to customize the API response.

Name Description Required Default
page Specifies the page number to retrieve. No 1
paginate Defines the number of items returned per page. No 20
search Search by payment ID/TRX. No -
php 

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/payment-status/payment_id',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'client-id: YOUR-CLIENT-ID',
    'client-secret: YOUR-CLIENT-SECRET',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Payment Status

This endpoint allows you to retrieve a payment status associated with your Cryptorch account.

GET
payment-status/{payment_id}
php 

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/supported-currencies',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'client-id: YOUR-CLIENT-ID',
    'client-secret: YOUR-CLIENT-SECRET',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Get Platform Supported Currencies

This endpoint allows you to retrieve a complete list of Cryptorch supported currencies. Each currency includes a type. Please refer to the definitions below:

Currency Type:
Crypto Currency = 1
Fiat Currency = 0

GET
supported-currencies
Query Parameters

Query parameters that allow you to customize the API response.

Name Description Required Default
page Specifies the page number to retrieve. No 1
paginate Defines the number of items returned per page. No 20
search Search by currency name or code. No -
php 

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://v2.eloquent-chaplygin.138-197-179-12.plesk.page/api/payment-initiate',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_POST => true, // <- Use POST
    CURLOPT_POSTFIELDS => array(
        'amount'            => 100,
        'currency_id'       => '2', // your invoice currency id (e.g. 2 = USD) - see Supported Currencies
        'merchant_trx'      => 'TX123456',
        'success_url'       => 'https://example.com/success',
        'failed_url'        => 'https://example.com/failed',
        'ipn_url'           => 'https://example.com/ipn',
        'order_description' => 'Payment for Order #9876',
    ),
    CURLOPT_HTTPHEADER => array(
        'client-id: YOUR-CLIENT-ID',
        'client-secret: YOUR-CLIENT-SECRET',
    ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

Create Invoice

This endpoint allows you to create an invoice on Cryptorch to collect payment from your customers.

POST
payment-initiate
Required Fields

The following fields are required to create a new contact in the system.

Name Required Description
amount Required The total amount to be charged for the invoice.
currency_id Required The currency identifier in which the invoice will be processed.
merchant_trx Required A unique transaction reference provided by the merchant.
success_url Required The URL where the customer will be redirected after a successful payment.
failed_url Required The URL where the customer will be redirected if the payment fails.
ipn_url Required The endpoint URL that will receive Instant Payment Notification (IPN) callbacks. This URL only call when payment is successful. This URl must post method and ensure the exclude CSRF or similar token
order_description Required A brief description of the order or service associated with this invoice.