API Documentation

Introduction

The ApiCrypto API allows you to accept cryptocurrency payments simply and securely. Our API is public and does not require authentication, making integration easy.

Authentication

The ApiCrypto API is public and does not require authentication. You can make requests directly to our endpoints without the need for API keys or tokens.

Available Endpoints

Create Transaction

Creates a new payment transaction and returns the address where the customer should send the cryptocurrency.

Parameters

Request Example

curl -X POST https://api.apicrypto.me/v1/transaction/create \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f6E123",
    "amount": 0.1,
    "currency": "ETH",
    "network": "ethereum",
    "webhook_url": "https://mysite.com/webhook/payment"
  }'

Success Response

{
  "success": true,
  "data": {
    "transaction_id": "TRX1A2B3C4D5E6F7G8H",
    "payment_address": "0x9876543210abcdef1234567890abcdef12345678",
    "amount": 0.1,
    "currency": "ETH",
    "network": "ethereum",
    "expires_at": "2024-01-20 15:30:00",
    "status": "pending",
    "qr_code": "data:image/png;base64,..."
  }
}

Check Status

Checks the status of a specific transaction.

Route Parameters

Request Example

curl https://api.apicrypto.me/v1/transaction/status/TRX1A2B3C4D5E6F7G8H

Success Response

{
  "success": true,
  "data": {
    "transaction_id": "TRX1A2B3C4D5E6F7G8H",
    "status": "completed",
    "confirmations": 12,
    "tx_hash": "0x123abc...",
    "created_at": "2024-01-20 15:00:00",
    "completed_at": "2024-01-20 15:15:00"
  }
}

Webhooks

Receive real-time notifications when a transaction status changes.

Webhook Events

• transaction.pending - Transaction created and awaiting payment
• transaction.confirmed - Payment received and confirmed
• transaction.completed - Transaction processed and funds transferred
• transaction.failed - Transaction failed or expired

Payload Example

{
  "event": "transaction.completed",
  "data": {
    "transaction_id": "TRX1A2B3C4D5E6F7G8H",
    "status": "completed",
    "amount": 0.1,
    "currency": "ETH",
    "network": "ethereum",
    "tx_hash": "0x123abc...",
    "confirmations": 12
  },
  "timestamp": "2024-01-20T15:15:00Z"
}

Errors

The API returns standardized errors in JSON format.

Error Codes

Error Response Example

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "The 'amount' field must be greater than zero",
    "field": "amount"
  }
}

Integration Examples

<?php
// Create transaction
$data = [
    'wallet_address' => '0x742d35Cc6634C0532925a3b844Bc9e7595f6E123',
    'amount' => 0.1,
    'currency' => 'ETH',
    'network' => 'ethereum',
    'webhook_url' => 'https://mysite.com/webhook'
];

$ch = curl_init('https://api.apicrypto.me/v1/transaction/create');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Send {$result['data']['amount']} {$result['data']['currency']} to:";
    echo $result['data']['payment_address'];
}

// Create transaction
const data = {
    wallet_address: '0x742d35Cc6634C0532925a3b844Bc9e7595f6E123',
    amount: 0.1,
    currency: 'ETH',
    network: 'ethereum',
    webhook_url: 'https://mysite.com/webhook'
};

fetch('https://api.apicrypto.me/v1/transaction/create', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
    if (result.success) {
        console.log(`Send ${result.data.amount} ${result.data.currency} to:`);
        console.log(result.data.payment_address);
    }
});

import requests
import json

# Create transaction
data = {
    'wallet_address': '0x742d35Cc6634C0532925a3b844Bc9e7595f6E123',
    'amount': 0.1,
    'currency': 'ETH',
    'network': 'ethereum',
    'webhook_url': 'https://mysite.com/webhook'
}

response = requests.post(
    'https://api.apicrypto.me/v1/transaction/create',
    json=data,
    headers={'Content-Type': 'application/json'}
)

result = response.json()

if result['success']:
    print(f"Send {result['data']['amount']} {result['data']['currency']} to:")
    print(result['data']['payment_address'])

Rate Limits

To ensure service quality, we apply rate limits per IP: