> For the complete documentation index, see [llms.txt](https://amplify-docs.gitbook.io/amplify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://amplify-docs.gitbook.io/amplify/espanol/api/links-de-pago.md).

# Links de Pago

Los links de pago son generados para redirigir a una url de Amplify, en donde el consumidor puede realizar el pago y ser redirigido nuevamente a la página del comprador. Es una alternativa al uso del sdk.

## API

\[POST] <https://api.getamplify.app/payment\\_link>

{% hint style="info" %}
**Autenticación requerida.**\
Para utilizar este endpoint es necesario enviar los siguientes headers:<br>

```json
{
  "apiKey": "123xxx456",
  "clientId": "123xxx456",
}
```

{% endhint %}

Crea un link de pago

```json
{
   "name": "Link de pago",
    "description": "Descripción del link de pago",
    "amount": 1, 
    "metadata": {
        "order_id": "123456",
        "customer_id": "123456"
    },
    "expires_at": "2050-12-31T23:59:59Z",
    "max_uses": 1
}
```

<table><thead><tr><th>Campo</th><th width="111" data-type="checkbox">Requerido</th><th width="146">Valor</th><th>Descripción</th></tr></thead><tbody><tr><td>name</td><td>true</td><td>string</td><td>Nombre a mostrar en el checkout</td></tr><tr><td>description</td><td>true</td><td>string</td><td>Descripción a mostrar en el checkout</td></tr><tr><td>amount</td><td>true</td><td>number</td><td>Precio en USD, acepta valores mayores a 1 y hasta 6 posiciones decimales</td></tr><tr><td>metadata</td><td>false</td><td>object</td><td>Metadata que el vendedor decida enviar para hacer un seguimiento de la venta</td></tr><tr><td>expires_at</td><td>false</td><td>ISO 8601, UTC</td><td>Fecha de expiración del link de pago, luego de esta fecha el link es invalidado</td></tr><tr><td>max_uses</td><td>false</td><td>int</td><td>Cantidad máxima de usos del link de pago</td></tr></tbody></table>

Respuesta:

```json
{
    "name": "Link de Pago",
    "shortId": "ABC123",
    "description": "Descripción",
    "amount": "1",
    "metadata": null,
    "status": "ACTIVE",
    "receiverId": "1234",
    "userId": "1234",
    "uses": 0,
    "apiKeyType": "PRODUCTION",
    "logic": "SELF",
    "_id": "679252ab508d61f025fc5c30",
    "created_at": "2025-01-23T14:31:07.473Z",
    "updated_at": "2025-01-23T14:31:07.473Z",
    "__v": 0
}
```

### Redirección

Para utilizar el link de pago debemos insertar el **shortId** en las siguientes urls:

***

**DESARROLLO**: [https://test.getamplify.app/payments/${shortId}](https://test.getamplify.app/payments/$%7BshortId%7D)

**PRODUCCIÓN**: [https://getamplify.app/payments/${shortId}](https://getamplify.app/payments/$%7BshortId%7D)

***

Si deseamos que cuando se complete el pago se redirija automáticamente a alguna URL, debemos envíar dicha URL en el query param redirect\_url.

Ejemplo:

<https://getamplify.app/payments/ABC123?redirect_url=https://getamplify.app>

La URL debe estar codificada para evitar errores de redirección.