Guías

Links de pago

Una página que puedes compartir y que crea una factura nueva cada vez que alguien paga. Sin programar nada: comparte la url por email, chat o redes sociales.

Link de un producto

Con product_id el link copia el título, el precio y la moneda del producto en el momento de crearlo.

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/payment-links' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
  "product_id": "1f0c6d9e-4a59-4f5e-9b51-2d3c0c3a8f10"
}'

Importe fijo o abierto

Sin producto, envía title, currency y un amount fijo o allow_custom_amount: true para que el pagador escriba el importe (opcionalmente entre min_amount y max_amount), útil para donaciones o propinas.

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/payment-links' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "Donation",
  "currency": "USD",
  "allow_custom_amount": true,
  "min_amount": "5.00",
  "max_amount": "500.00",
  "collect_email": true
}'

Límites

Usa reusable: false para un solo pago, max_uses para limitar el número de pagos o expires_at para cerrarlo en una fecha. status indica si está active, inactive, expired o exhausted. Desactívalo con POST /payment-links/{id}/deactivate.

Las facturas creadas desde un link llevan su id en payment_link_id, así tu manejador de webhooks puede distinguirlas.