> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Payment Links
> Acepta pagos fácilmente sin código.
Con los Payment Links puedes aceptar pagos sin construir un sitio web o aplicación. Crea un Payment Link usando nuestra API y compártelo con tus clientes por correo electrónico o WhatsApp.
# Crear un Payment Link
Usando tu [Secret Key](/es/v2023-11-15/docs/home/api-keys), crea un payment link desde tu backend con el `amount` y `currency`:
```curl theme={null}
curl --request POST "https://api.fintoc.com/v1/payment_links" \
--header 'Authorization: sk_test_0000000000000000' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 120900,
"currency": "MXN",
"expires_after_seconds": 86400,
"customer_email": "customer@example.com",
"checkout": {
"description": "Use this field to add a custom description of the product the customer is buying"
},
"metadata": {
"your_order_id": "10000"
},
"recipient_account": {
"holder_id": "771433855",
"number": "1836027172",
"type": "checking_account",
"institution_id": "cl_banco_de_chile"
},
"business_profile": {
"name": "Merchant Name",
"category": "009613",
"tax_id": "774981120"
}
}'
```
**Monedas representadas como enteros**
La API de Fintoc representa las monedas en sus unidades más pequeñas posibles sin decimales (como un entero). Eso significa que un monto de MXN 247.50 se representa en Fintoc como 24750. Puedes leer más sobre monedas [aquí](/es/v2023-11-15/docs/home/currencies).
Los parámetros `customer_email`, `checkout`, `metadata` y `business_profile` son opcionales. Algunos de los parámetros opcionales que puedes usar para crear tu payment link son:
| Parámetros opcionales | Tipo | Descripción |
| :--------------------- | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `expire_after_seconds` | `integer` | El número de segundos después de los cuales el payment link expirará. Por defecto, un payment link no expirará. |
| `customer_email` | `string` | Si se establece un correo de cliente, Fintoc enviará al cliente un correo en caso de un reembolso. |
| `checkout` | `dictionary` | Personaliza el checkout para tus clientes. Por ahora, solo puedes agregar una descripción personalizada junto al botón de compra. |
| `metadata` | `hash` | Conjunto de pares clave-valor que puedes adjuntar al payment link. Esto puede ser útil para almacenar información adicional que puedes usar para conciliar el pago con tus sistemas internos. |
| `recipient_account` | `object` | El objeto recipient account debe incluirse si tu organización usa [Pagos Directos](/es/v2023-11-15/docs/payments/direct-payments) . |
| `business_profile` | `object` | Objeto para identificar comercios inscritos para precios basados en categoría. |
El objeto recipient account está definido por 4 atributos:
| Parámetro | Ejemplo | Explicación |
| :--------------- | :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `holder_id` | 193426816 | [RUT](https://es.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario) del titular de la cuenta |
| `number` | 1836027172 | Número de cuenta |
| `type` | checking\_account | Tipo de cuenta. Los tipos admitidos son `checking_account` y `sight_account`. |
| `institution_id` | cl\_banco\_de\_chile | ID de institución de Fintoc del banco que recibe la transferencia bancaria. Puedes ver el código para cada banco [aquí](/es/v2023-11-15/docs/payments/direct-payments/setup-direct-payment#available-recipient-banks) |
Para una lista completa de parámetros, revisa la API de Payment Link.
# Comparte tu Payment Link
Cada payment link contiene una `url` que puedes compartir con tus clientes por correo electrónico, WhatsApp o a través de otros canales.
```json json theme={null}
{
"id": "plink_K2zwNNSxPyx8w3GZ",
"object": "payment_link",
"amount": 120900,
"currency": "MXN",
"status": "active",
"created_at": "2024-08-02T20:28:13Z",
"expires_at": "2024-08-02T21:28:13Z",
"mode": "test",
"url": "https://pay.fintoc.com/plink_K2zwNNSxPyx8w3GZ",
"customer_email": "customer@example.com",
"checkout": {
"description": "Use this field to add a custom description of the product the customer is buying"
},
"metadata": {
"your_order_id": "10000"
},
"recipient_account": {
"holder_id": "771433855",
"number": "1836027172",
"type": "checking_account",
"institution_id": "cl_banco_de_chile"
},
"business_profile": {
"name":"Merchant Name",
"category": "009613",
"tax_id": "774981120"
}
}
```
# Rastrear pagos
Cuando los clientes usan un payment link para completar un pago, Fintoc envía un webhook `payment_intent.succeeded` que puedes usar para cumplimiento y conciliación. **Este webhook contendrá las claves `metadata` que usaste para crear el payment link**.
Para más información, consulta nuestra guía sobre [cómo completar el pago en tu backend](/es/v2023-11-15/docs/payments/accept-a-payment#complete-the-payment-on-your-backend). En el caso de payment links, te recomendamos escuchar solo los eventos `payment_intent.succeeded`.
También puedes ver los pagos exitosos usando nuestro [Dashboard](https://dashboard.fintoc.com/).
# Cancelar un Payment Link
Puedes cancelar un payment link usando el endpoint de cancelación:
```curl curl theme={null}
curl --request PATCH \
--url https://api.fintoc.com/v1/payment_links/plink_K2zwNNSxPyx8w3GZ/cancel \
--header 'Authorization: sk_test_9c8d8CeyBTx1VcJzuDgpm4H' \
--header 'accept: application/json
```
Después de cancelar un payment link, los clientes ya no pueden finalizar compras usando el enlace y son redirigidos a una página de expiración.