> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplepay.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: Payment Links

> Crea un link de pago reusable o de un solo uso para invoices, ventas manuales y cobros asincronos.

Payment Links sirve cuando no quieres construir un checkout por orden en tiempo real. Creas un link, lo mandas por email, WhatsApp, CRM o panel interno, y confirmas el resultado por webhook.

## 1. Crea el link

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X POST "https://api.simplepay.mx/v1/payment-links" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: invoice_2026_0007_link_v1" \
  -d '{
    "currency": "mxn",
    "line_items": [
      {
        "name": "Factura 2026-0007",
        "amount": 125000,
        "quantity": 1
      }
    ],
    "max_payments": 1,
    "metadata": {
      "invoice_id": "2026-0007"
    }
  }'
```

## 2. Comparte la URL

Persiste `splink_...` y comparte el campo `url` que responde SimplePay.

```txt theme={"theme":{"light":"github-light","dark":"github-dark"}}
splink_... -> https://link.simplepay.mx/splink_...
```

## 3. Reconciliacion

Cuando el pago se complete, tu backend debe reconciliar usando webhook o lectura de API. No dependas de que el usuario vuelva a tu sitio.

## Siguiente

* Guia completa: [Payment Links](/payments/payment-links)
* Endpoint create: [POST /v1/payment-links](/api-reference/endpoints/payment-links/create-payment-link)
* Endpoint read: [GET /v1/payment-links/{id}](/api-reference/endpoints/payment-links/get-payment-link)