Vista previa: el pago con CrypCash aún no está abierto, y los planes y funciones pueden cambiar antes del lanzamiento.

Todas las guías

Conecta CrypCash desde tu propio código

Para desarrolladores: crea facturas con la API REST, envía a tu cliente a la página de pago o haz la tuya, y actualiza los pedidos con webhooks firmados.

Antes del lanzamiento: estas guías describen cómo será la instalación. El panel de CrypCash, el plugin de WooCommerce y la página de pago aún no están abiertos.

Lo que necesitas

  • Tu clave secreta, guardada en tu servidor (mira Antes de empezar)
  • Una dirección HTTPS en tu servidor para los avisos
  1. Crea una factura cuando se haga el pedido

    Llama a la API desde tu servidor con el total del pedido, en USDT, o en la moneda de tu tienda con currency (por ejemplo INR o EUR). CrypCash lo convierte al precio de mercado y fija el importe durante el tiempo de la factura. Envía el ID del pedido como Idempotency-Key: si la petición se repite, recibes la misma factura, no una segunda.

    network es TRON o BSC, y la moneda es USDT. Campos opcionales: orderId, description, customerEmail, metadata (hasta 20 claves), successUrl, cancelUrl y expiresInMinutes (de 5 a 60, 15 por defecto).

    Crear una factura
    curl -X POST https://api.crypcash.io/api/v1/invoices \
      -H "Authorization: Bearer $CRYPCASH_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: order-1042" \
      -d '{"amount":"4199","currency":"INR","network":"TRON","orderId":"1042","successUrl":"https://your-store.com/thanks"}'

    Haz clic o toca el código una vez para seleccionarlo entero.

  2. Envía a tu cliente a pagar

    Redirige a checkoutUrl de la respuesta. La página alojada muestra el importe, la dirección y un código QR, y sigue el pago hasta que es definitivo. Para un precio en otra moneda, price guarda tu precio original y exchangeRate el precio con que se convirtió.

    ¿Haces tu propia página? Muestra payAmount, no amount: en una única dirección de TRON o BNB Smart Chain es hasta 0,0999 USDT mayor, y esa diferencia es lo que asigna el pago a la factura.

    La respuesta, resumida
    201 Created
    {
      "id": "inv_…",
      "status": "PENDING",
      "network": "TRON",
      "currency": "USDT",
      "amount": "47.48",
      "payAmount": "47.4837",
      "price": { "amount": "4199", "currency": "INR" },
      "exchangeRate": { "currency": "INR", "asset": "USDT", "price": "88.4512", "source": "coingecko", "at": "2026-11-04T12:00:00.000Z" },
      "depositAddress": "T…",
      "paymentUri": null,
      "checkoutUrl": "https://crypcash.io/i/inv_…",
      "expiresAt": "2026-11-04T12:15:00.000Z"
    }
  3. Añade la dirección de tu webhook

    Añade la dirección HTTPS que recibe los avisos y copia el secreto de firma que muestra CrypCash. Guárdalo en el servidor, junto a tu clave secreta.

    Panel de CrypCash

    1. Tiendas
    2. Tu tienda
    3. Webhooks
    4. Añadir dirección
  4. Comprueba la firma de cada aviso

    Cada aviso lleva CrypCash-Signature: t=<seconds>,v1=<hex>: un HMAC-SHA256 con tu secreto de firma sobre t, un punto y el cuerpo tal como llegó. Rechaza una firma incorrecta, y una de más de cinco minutos.

    Lee el cuerpo en bruto, antes de que lo toque un parser de JSON. Un JSON leído y vuelto a escribir ya no coincide con la firma.

    Node.js (Express)
    import express from "express";
    import { createHmac, timingSafeEqual } from "node:crypto";
    
    function verify(secret, rawBody, header = "") {
      const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
      if (!/^\d+$/.test(t ?? "") || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
      const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest();
      const given = Buffer.from(v1 ?? "", "hex");
      return given.length === expected.length && timingSafeEqual(given, expected);
    }
    
    const app = express();
    app.post("/api/crypcash/webhook", express.raw({ type: "application/json" }), (req, res) => {
      const raw = req.body.toString("utf8");
      if (!verify(process.env.CRYPCASH_WEBHOOK_SECRET, raw, req.get("CrypCash-Signature"))) return res.sendStatus(400);
      const event = JSON.parse(raw);
      if (event.type === "invoice.paid" || event.type === "invoice.overpaid") {
        markOrderPaid(event.data.invoice.orderId, event.id);
      }
      res.sendStatus(200);
    });
    PHP
    <?php
    function crypcash_verify(string $secret, string $rawBody, string $header): bool {
        $parts = [];
        foreach (explode(',', $header) as $pair) {
            [$key, $value] = array_pad(explode('=', $pair, 2), 2, '');
            $parts[$key] = $value;
        }
        $t = $parts['t'] ?? '';
        if (!ctype_digit($t) || abs(time() - (int) $t) > 300) {
            return false;
        }
        $expected = hash_hmac('sha256', $t . '.' . $rawBody, $secret);
        return hash_equals($expected, $parts['v1'] ?? '');
    }
    
    $raw = file_get_contents('php://input');
    if (!crypcash_verify((string) getenv('CRYPCASH_WEBHOOK_SECRET'), $raw, $_SERVER['HTTP_CRYPCASH_SIGNATURE'] ?? '')) {
        http_response_code(400);
        exit;
    }
    $event = json_decode($raw, true);
    if (in_array($event['type'], ['invoice.paid', 'invoice.overpaid'], true)) {
        mark_order_paid($event['data']['invoice']['orderId'], $event['id']);
    }
    http_response_code(200);
  5. Actualiza el pedido según el evento

    El nombre del evento está en type y en la cabecera CrypCash-Event, y la factura en data.invoice, con tu orderId. Responde con cualquier estado 2xx en menos de 10 segundos; si no, CrypCash lo reintenta con esperas cada vez más largas, de un minuto hasta un día.

    Un evento repetido conserva su id. Guarda los ID que ya has tratado y omite los repetidos.

    invoice.confirming
    Se ve el pago, pero aún no es definitivo. Muéstralo como «confirmando» y no envíes todavía.
    invoice.paid
    Pagado por completo. Marca el pedido como pagado.
    invoice.overpaid
    Pagado de más. Márcalo como pagado; data.invoice.receivedAmount tiene lo que llegó.
    invoice.underpaid
    Se acabó el tiempo con parte del importe recibido. Decide con tu cliente.
    invoice.expired
    No llegó nada a tiempo. Libera el pedido.
  6. Pruébalo con un pago real

    Crea una factura de 1 USDT y págala desde otra billetera tuya. El dinero llega a tu propia dirección, así que solo pagas la comisión de la red. Comprueba que tu servidor aceptó la firma y movió el pedido.

Si algo no funciona

401 unauthorized

Falta la clave, es incorrecta o está revocada. Envía la clave secreta, que empieza por cc_sk_, en Authorization: Bearer.

402 volume_cap_exceeded

Esta factura superaría el volumen mensual de tu plan. El error dice cuánto queda: mejora el plan, o espera al mes siguiente.

403 publishable_key_not_allowed

Las facturas con importe necesitan la clave secreta, desde tu servidor. La clave pública no puede fijar un importe, porque un cliente puede cambiar cualquier cosa en su navegador.

422 wallet_not_configured

La tienda no tiene billetera activa para esa network. Añade una en el panel.

422 asset_not_supported

Esa moneda no se acepta en esa red. Envía USDT en TRON o BNB Smart Chain.

422 asset_not_accepted

La tienda desactivó esa moneda en su billetera de esa red. Actívala en el panel, o envía la otra moneda.

422 currency_not_supported

CrypCash no tiene precio de mercado para esa currency. Envía el importe en la moneda de la factura, o en una moneda que convierta.

503 rate_unavailable

El precio de esa moneda está desactualizado, así que CrypCash no convierte con él. Vuelve a intentarlo tras el tiempo de Retry-After.

429 rate_limited

Demasiadas peticiones a la vez. Espera los segundos que indica la cabecera Retry-After.

La firma nunca coincide.

Lo más probable es que compruebes un JSON ya leído. Usa el cuerpo en bruto, el secreto de firma (no la clave de API) y t, un punto y el cuerpo.

Siguiente guíaOtras plataformasLa API, un enlace de pago o un método de pago manual

Shopify, WooCommerce, WordPress, Framer, Webflow, v0, Lovable, Bolt y Trustpilot son marcas de sus propietarios. CrypCash no tiene relación con ellos.