Payment links

Un payment link es una página pública con un título, un precio en USD y los pares de red y token que aceptás. Compartí su URL donde quieras. Cada vez que un comprador inicia un pago, Aliquot crea una factura nueva en AWAITING_SELECTION y manda al comprador al hosted checkout de esa factura, donde elige uno de los pares aceptados.

Usá un payment link cuando el precio es fijo y no necesitás crear una factura por pedido desde tu servidor. Usá facturas cuando necesitás splits, tu propio ID de pedido o un monto por comprador.

Crear un link

POST /api/v1/crypto/payment-links — permiso crypto-links:create. Sin Idempotency-Key.

curl -X POST https://api.aliquot.cc/api/v1/crypto/payment-links \
  -H "Authorization: Bearer $ALIQUOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Halden Grotesk — Desktop license",
    "description": "Five desktop seats, OTF and TTF.",
    "amount": "49.00",
    "accepted_pairs": [
      { "network": "POLYGON_AMOY", "token": "USDC" },
      { "network": "BASE_SEPOLIA", "token": "USDC" }
    ],
    "merchant": "halden_type",
    "redirect_url": "https://shop.example.com/thanks"
  }'

Un link de Sandbox usa las redes de prueba; un link cuyos pares son todos de redes Live recibe pagos reales.

Entrega

La entrega (fulfilment) es lo que el comprador recibe en el comprobante del checkout cuando la factura está PAID u OVERPAID:

• Nunca antes del pago. En cualquier otro estado, el fulfillment de la vista pública es null; el payload no llega al navegador.
• Fija por factura. La entrega se copia a la factura cuando el comprador inicia el checkout. Editar el link cambia lo que entregan los checkouts siguientes, nunca el comprobante de una factura que ya existe.
• Comprobante público. Cualquiera que tenga el ID de la factura puede abrir el comprobante, igual que el resto del checkout. Para algo que tiene que quedar atado a un solo comprador, usá una URL firmada que venza o entregá desde tu webhook.
• Sin vuelta automática. Un comprobante con entrega no hace la cuenta regresiva a redirect_url; el comprador tiene un botón para volver.

La vista pública (GET /api/v1/public/pay/{id} y su stream) la trae así:

"fulfillment": { "type": "FILE_DOWNLOAD", "payload": "https://files.example.com/halden-grotesk.zip" }

Todos los webhooks invoice.* traen payment_link_id, así que tu handler de invoice.paid sabe de qué link vino el pago sin hacer otro request.

El objeto link

201 Created devuelve:

{
  "id": "plink_01JB7RZ4C2W8M6Q1N3H5T7V9XA",
  "slug": "k7m2q9x4hd",
  "url": "https://aliquot.cc/l/k7m2q9x4hd",
  "livemode": false,
  "title": "Halden Grotesk — Desktop license",
  "description": "Five desktop seats, OTF and TTF.",
  "amount": "49.00",
  "currency": "USD",
  "merchant": { "reference": "halden_type", "name": "Halden Type" },
  "accepted_pairs": [
    { "network": "POLYGON_AMOY", "token": "USDC" },
    { "network": "BASE_SEPOLIA", "token": "USDC" }
  ],
  "fee_payer": null,
  "markup_percent": null,
  "fulfillment_type": "NONE",
  "fulfillment_payload": null,
  "redirect_url": "https://shop.example.com/thanks",
  "active": true,
  "sales_count": 0,
  "created_at": "2026-10-27T14:00:00.000Z",
  "updated_at": "2026-10-27T14:00:00.000Z"
}

Aliquot genera el slug; compartí url. sales_count cuenta las facturas de este link que llegaron a PAID u OVERPAID.

Listar, consultar y actualizar

No hay borrado. Para dar de baja un link, poné "active": false: su página responde 404 y no crea facturas nuevas. Las facturas que ya creó no se ven afectadas. Los cambios aplican a los checkouts que se inicien después.

Qué crea un checkout

Cuando un comprador inicia un pago en https://aliquot.cc/l/{slug}, la factura nueva recibe:

• el title, la description, el amount, el merchant y la redirect_url del link;
• el fee_payer y el markup_percent del link, o los valores por defecto de la organización cuando son null;
• sin splits, sin merchant_order_id, sin buyer_email y sin metadata;
• payment_link_id con el id del link, y una copia de la entrega del link;
• el entorno del link, y la ventana de pago por defecto de la organización (30 minutos), que vuelve a arrancar completa cuando el comprador elige un par.

Estas facturas se comportan como cualquier otra: aparecen en GET /api/v1/crypto/invoices y mandan los mismos webhooks.

Endpoints públicos

La página del link usa dos endpoints sin autenticación, que podés llamar para poner un botón de pago en tu propia página:

allowed_pairs lista los pares aceptados que en este momento pueden recibir pagos.