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
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 comoIdempotency-Key: si la petición se repite, recibes la misma factura, no una segunda.networkesTRONoBSC, y la moneda es USDT. Campos opcionales:orderId,description,customerEmail,metadata(hasta 20 claves),successUrl,cancelUrlyexpiresInMinutes(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.
Envía a tu cliente a pagar
Redirige a
checkoutUrlde 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,priceguarda tu precio original yexchangeRateel precio con que se convirtió.¿Haces tu propia página? Muestra
payAmount, noamount: 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" }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
- Tiendas
- Tu tienda
- Webhooks
- Añadir dirección
Comprueba la firma de cada aviso
Cada aviso lleva
CrypCash-Signature: t=<seconds>,v1=<hex>: un HMAC-SHA256 con tu secreto de firma sobret, 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);Actualiza el pedido según el evento
El nombre del evento está en
typey en la cabeceraCrypCash-Event, y la factura endata.invoice, con tuorderId. Responde con cualquier estado2xxen 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.receivedAmounttiene 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.
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.
Shopify, WooCommerce, WordPress, Framer, Webflow, v0, Lovable, Bolt y Trustpilot son marcas de sus propietarios. CrypCash no tiene relación con ellos.