Documentación API

Introducción

La API ApiCrypto te permite aceptar pagos en criptomonedas de forma simple y segura. Nuestra API es pública y no requiere autenticación, facilitando la integración.

Autenticación

La API ApiCrypto es pública y no requiere autenticación. Puedes hacer solicitudes directamente a nuestros endpoints sin necesidad de claves API o tokens.

Endpoints Disponibles

Crear Transacción

Crea una nueva transacción de pago y devuelve la dirección donde el cliente debe enviar las criptomonedas.

Parámetros

Ejemplo de Solicitud

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

Respuesta de Éxito

{
  "success": true,
  "data": {
    "tid": "TRX9E7CCB47B8145B2B",
    "network": "ETHEREUM",
    "currency": "ETH",
    "payment_address": "0x354FECB1d5022426c678D926935F1A007B77444b",
    "amount": "0.1",
    "expires_at": "2025-07-14 18:35:05"
  }
}

Verificar Estado

Verifica el estado de una transacción específica.

Parámetros de Ruta

Ejemplo de Solicitud

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

Respuesta de Éxito

{
  "success": true,
  "data": {
    "tid": "TRX9E7CCB47B8145B2B",
    "status": "PENDING",
    "paid": "NO",
    "tx_hash": null,
    "network": "BSC",
    "currency": "BNB",
    "amount": "0.00026216",
    "created_at": "2025-07-14 18:05:05",
    "updated_at": null
  }
}

Monedas Soportadas

Lista todas las criptomonedas soportadas y sus redes.

Ejemplo de Solicitud

curl https://apicrypto.me/api/v1/supported/currencies

Respuesta de Éxito

{
  "success": true,
  "data": {
    "BITCOIN": [
      {
        "symbol": "BTC",
        "name": "Bitcoin",
        "decimals": 8,
        "min_amount": "0.0001"
      }
    ],
    "ETHEREUM": [
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "decimals": 18,
        "min_amount": "0.001"
      }
    ],
    "BSC": [
      {
        "symbol": "BNB",
        "name": "Binance Coin",
        "decimals": 18,
        "min_amount": "0.001"
      }
    ],
    "POLYGON": [
      {
        "symbol": "POL",
        "name": "Polygon",
        "decimals": 18,
        "min_amount": "0.1"
      }
    ]
  }
}

Estado de Redes

Muestra el estado operacional de todas las redes blockchain.

Ejemplo de Solicitud

curl https://apicrypto.me/api/v1/network/status

Respuesta de Éxito

{
  "success": true,
  "data": {
    "BITCOIN": {
      "name": "Bitcoin",
      "status": "degraded",
      "confirmations_required": 3,
      "average_block_time": "10 minutes",
      "available_wallets": 0,
      "pending_transactions": 0
    },
    "ETHEREUM": {
      "name": "Ethereum",
      "status": "degraded",
      "confirmations_required": 12,
      "average_block_time": "12 seconds",
      "available_wallets": 0,
      "pending_transactions": 0
    },
    "BSC": {
      "name": "Binance Smart Chain",
      "status": "degraded",
      "confirmations_required": 12,
      "average_block_time": "3 seconds",
      "available_wallets": 0,
      "pending_transactions": 1
    },
    "POLYGON": {
      "name": "Polygon",
      "status": "degraded",
      "confirmations_required": 128,
      "average_block_time": "2 seconds",
      "available_wallets": 0,
      "pending_transactions": 0
    }
  }
}

Webhooks

Recibe notificaciones en tiempo real cuando cambia el estado de una transacción.

Configuración de Webhook

Agrega el parámetro webhook_url al crear una transacción:

{
  "network": "ethereum",
  "currency": "ETH",
  "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f6E123",
  "amount": 0.1,
  "webhook_url": "https://tusitio.com/webhook/payment"
}

Ejemplo de Payload

{
  "tid": "TRX9E7CCB47B8145B2B",
  "status": "CONFIRMED",
  "timestamp": "2025-07-14 18:15:00"
}

Errores

La API devuelve errores estandarizados en formato JSON.

Códigos de Error

Ejemplo de Respuesta de Error

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "El campo amount debe ser mayor que cero",
    "field": "amount"
  }
}

Ejemplos de Integración

<?php
// Crear transacción
$data = [
    'network' => 'bsc',
    'currency' => 'BNB',
    'wallet_address' => '0x742d35Cc6634C0532925a3b844Bc9e7595f6E123',
    'amount' => 0.1,
    'webhook_url' => 'https://tusitio.com/webhook'
];

$ch = curl_init('https://apicrypto.me/api/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 "Enviar {$result['data']['amount']} {$result['data']['currency']} a:";
    echo $result['data']['payment_address'];
}

// Crear transacción
const data = {
    network: 'bsc',
    currency: 'BNB',
    wallet_address: '0x742d35Cc6634C0532925a3b844Bc9e7595f6E123',
    amount: 0.1,
    webhook_url: 'https://tusitio.com/webhook'
};

fetch('https://apicrypto.me/api/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(`Enviar ${result.data.amount} ${result.data.currency} a:`);
        console.log(result.data.payment_address);
    }
});

import requests
import json

# Crear transacción
data = {
    'network': 'bsc',
    'currency': 'BNB',
    'wallet_address': '0x742d35Cc6634C0532925a3b844Bc9e7595f6E123',
    'amount': 0.1,
    'webhook_url': 'https://tusitio.com/webhook'
}

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

result = response.json()

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

Límites de Tasa

Para garantizar la calidad del servicio, aplicamos límites de tasa por IP: