Priem
Entrar Empezar

Aceptación de pagos — cripto y tarjeta

Tu cliente paga como quiere. Tú recibes justo lo que pediste.

En la caja tu comprador elige la moneda y la red que prefiera — bitcoin, éter, USDT, USDC — o paga con una tarjeta corriente. A ti se te abona en la divisa que hayas fijado. El enlace de pago se pone en tu web sin una sola línea de código; la API solo hace falta cuando el importe sale del carrito.

Empezar Documentación

1,5% por pago. El panel se abre al instante; el cobro empieza tras la revisión.

  1. 01CompradorPaga con moneda o tarjeta en tu caja
  2. 02RedLa transferencia aparece y suma confirmaciones
  3. 03CambioLo recibido se cambia a tu divisa
  4. 04Tu saldoEstado settled: ya puedes enviar

01 / Conexión

Dos caminos, y no se excluyen

Un botón con un enlace resuelve la mayoría de los casos. La API es para cuando el precio se calcula en tu lado.

Sin código

Etiqueta de precio

La creas en el panel, copias el enlace y lo pones como botón en tu web. El precio es fijo o lo introduce el propio comprador.

La etiqueta puede ser reutilizable — para un artículo del catálogo, o de un solo uso — para la factura de una persona concreta. La de un solo uso se cierra en cuanto el primer comprador pasa a pagar: dos que abrieran el enlace a la vez no pagarán dos veces por lo mismo.

<a href="https://api.priem.io/pay/TU-ETIQUETA">
  Pagar con criptomonedas
</a>

Cuando el importe sale del carrito

API

Tu servidor crea el pago por el importe que necesita y lleva al comprador al enlace que recibe. El proyecto se identifica por la clave, así que no hace falta nombrarlo en el cuerpo.

POST https://api.priem.io/v1/payments
Authorization: Bearer priem_…

{
  "amount": "49.00",
  "currency": "USD",
  "idempotencyKey": "order-12345"
}

Toma la clave de idempotencia del número de pedido, no del reloj ni al azar. Repetir la petición con la misma clave devuelve el mismo pago en lugar de emitir una segunda factura. Una clave hecha con Date.now() no protege de nada.

El pago con tarjeta funciona en la misma caja y no tienes que configurar nada. El comprador compra bitcoin al proveedor, este llega directo a la dirección de la factura y el pago se tramita como cualquier otro.

El mínimo con tarjeta son 10 dólares. Por debajo el botón ni siquiera aparece, y al comprador se le explica por qué.

02 / Dinero

Cuánto cuesta — todo

Hay tres comisiones y solo una es nuestra. Las otras dos las cobra la red, y las enseñamos aquí y no después de que te des de alta.

A nosotros, por pago

1,5%

Se retiene al abonar y aparece en el callback como campo propio.

A la red, al retirar

~1 USDT

Fija en TRON, la pagas tú. Acumular y retirar de una vez sale más barato que pago a pago.

A la red, al pagar

La paga el comprador

Por encima de tu precio. No depende del importe, así que en un pedido pequeño se nota.

El recargo de red que ve el comprador antes de confirmar
Paga conPedido $5Pedido $30Pedido $100
USDT en BSC+1,3%+0,5%+0,3%
USDT en TON+9,3%+1,8%+0,8%
USDT en TRON+16,3%+3,0%+1,1%
USDT en Ethereum+19,5%+3,5%+1,3%

Salvedad Vender por menos de 10 dólares con criptomonedas es difícil. En un pedido de tres dólares hasta una red barata se come una parte visible, y TRON o Ethereum añaden un cuarto del precio. Si tus tarifas son pequeñas, véndelas en paquetes. Lo decimos antes de que te conectes, no después de los primeros pedidos abandonados.

03 / Desarrolladores

Una integración de una tarde

Crear el pago, esperar el callback, verificar la firma y enviar con settled. No hace falta nada más.

Manejador del callback · Node
// cuerpo en bruto, antes de parsear JSON:
// la firma se calcula sobre los bytes
const expected = createHmac('sha256', secret)
  .update(`${timestamp}.${rawBody}`)
  .digest('hex');

if (!timingSafeEqual(a, b)) return res.sendStatus(401);

markOrderPaid(event.paymentId, event.creditedAmount);
res.sendStatus(200);
  • Firma — HMAC-SHA256 de {timestamp}.{cuerpo}, cabeceras X-Priem-Timestamp y X-Priem-Signature.
  • Reintentos — siete intentos en día y medio: al minuto, a los 5 minutos, 30 minutos, 2 horas, 6 horas y un día.
  • Consulta — GET /v1/payments/{id} devuelve siempre el estado actual. No conviene fiarlo todo al callback.

Estados del pago

  • createdCreado, aún sin moneda elegida
  • awaiting_paymentMoneda elegida, esperando la transferencia
  • onramp_pendingPaga con tarjeta, compramos cripto
  • detectedLa transferencia se ve en la red
  • confirmingSumando confirmaciones
  • convertingCambiando a tu divisa
  • settledEl dinero está en tu saldo
  • underpaidLlegó menos de lo debido
  • expiredLa factura caducó
  • refundedDevuelto al comprador

Envía el pedido con settled y con nada más.

04 / Fiabilidad

Qué ocurre mientras vendes

El trabajo que no se ve desde el panel, y por cuya ausencia se pierde dinero.

Cuadre nocturno

Cada noche cuadramos todo lo que debemos a los comercios contra lo que hay realmente en el proveedor. Un descuadre detiene los pagos automáticamente — hasta aclararlo, no hasta la mañana.

Un día para las direcciones de retiro

Una dirección nueva de monedero queda disponible un día después de añadirla. Es lo único que separa un panel robado de un saldo vacío. Molesta exactamente una vez.

El defecto de pago corre de nuestra cuenta

El cambio se movió, el monedero se quedó lo suyo — llegó un poco menos. Dentro de la tolerancia (1% por defecto) el pago se cierra igual y tú recibes el importe íntegro de la etiqueta. La diferencia la ponemos nosotros.

Registro y bloqueo

Accesos, claves, direcciones, retiros y etiquetas se anotan en un registro ordenado por número correlativo. Cinco intentos fallidos de acceso bloquean la cuenta quince minutos.

05 / Antes de decidir

Conviene saberlo de antemano

El cobro no se activa al momento
El panel se abre en cuanto te registras, pero aceptar pagos empieza tras una revisión del negocio — lleva desde unas horas. No es burocracia: el dinero de tus clientes pasa por nuestra cuenta en el proveedor, y responder de quién vende a través de nosotros nos toca a nosotros. El proyecto, las claves, el callback y las etiquetas puedes configurarlos ya; el cobro se activa solo, sin que tengas que hacer nada.
La red de la dirección de retiro es obligatoria
USDT en TRON y USDT en BSC son direcciones distintas. Enviar a la red equivocada pierde el dinero para siempre, y nadie puede recuperarlo.
Haz el primer pago real de 20–30 dólares
No de dos: con ese importe la comisión de red añade cerca del cuarenta por ciento y concluirás que algo está roto. No lo estará — una comisión fija sobre un pedido diminuto simplemente resulta absurda.
La clave de API se muestra una sola vez
No hay de dónde recuperarla — solo emitir una nueva y revocar la anterior. Guárdala en el servidor: en el navegador sirve para crear pagos en tu nombre.
El panel y la documentación están en ruso
Esta página está traducida; el panel, la caja y la documentación siguen solo en ruso. Si eso te estorba, dínoslo al darte de alta — ordenamos la cola de traducción por a quién está frenando.

Priem.
¿Me copias?

Registrarse lleva un minuto y configurarlo media hora, y casi todo ese rato se va en el manejador del callback.

Empezar Leer la documentación