> ## 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.

# The Payment Link object

## The Payment Link object

The `PaymentLink` object represents a shareable `url` that lets a customer pay a fixed `amount` through a Fintoc-hosted page. It appears when you create a payment link, and its `status` field tracks the link as `active`, `expired`, or `canceled`.

```json Payment Link Object theme={null}
{
  "id": "plink_K2zwNNSxPyx8w3GZ",
  "object": "payment_link",
  "amount": 120900,
  "checkout": {
    "description": "Use this field to add a custom description of the product the customer is buying"
  },
  "created_at": "2024-08-02T20:28:13Z",
  "currency": "MXN",
  "customer_email": "customer@example.com",
  "expires_at": "2024-08-02T21:28:13Z",
  "metadata": {
    "your_order_id": "10000"
  },
  "mode": "test",
  "recipient_account": {
    "holder_id": "555555555",
    "institution_id": "cl_banco_de_chile",
    "number": "0000000000",
    "type": "checking_account"
  },
  "status": "active",
  "url": "https://pay.fintoc.com/plink_K2zwNNSxPyx8w3GZ"
}
```

| Attribute           | Type               | Description                                                                                                                                                                                                                                                  |
| ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                | `string`           | Unique identifier for the Payment Link.                                                                                                                                                                                                                      |
| `object`            | `string`           | Type of the object. Always `payment_link`.                                                                                                                                                                                                                   |
| `amount`            | `integer`          | Amount to charge, in the smallest currency unit. Must be greater than `0`.                                                                                                                                                                                   |
| `checkout`          | `object`           | Checkout customization shown to your customers. You can add a custom description alongside the buy button.                                                                                                                                                   |
| `created_at`        | `string`           | Payment Link's creation date, as an ISO 8601 datetime in UTC.                                                                                                                                                                                                |
| `currency`          | `string`           | Three-letter ISO 4217 currency code, in uppercase. One of `CLP` or `MXN`.                                                                                                                                                                                    |
| `customer_email`    | `string` or `null` | Email address used for refund notifications. If you create a payment without `customer_email`, this field is `null` and the customer does not receive refund notifications by email.                                                                         |
| `expires_at`        | `string` or `null` | Payment Link's expiration date, as an ISO 8601 datetime in UTC. If `null`, the payment link does not expire.                                                                                                                                                 |
| `metadata`          | `object` or `null` | Set of [key-value](/api/fintoc-api/metadata) pairs you can attach to the object, useful for storing additional structured information. If you create a payment without `metadata`, this field is `null` when receiving notifications about the final status. |
| `mode`              | `string`           | Indicates whether the Payment Link is in `live` mode or in `test` mode.                                                                                                                                                                                      |
| `recipient_account` | `object`           | Optional and only available in Chile. Include the recipient account object if your organization uses [Direct Payments](/guides/payments/direct-payments). See [The Recipient object](#the-recipient-object-within-the-payment-link-object).                  |
| `status`            | `string`           | Payment Link status. One of `active`, `expired`, or `canceled`.                                                                                                                                                                                              |
| `url`               | `string`           | Public URL you can share with customers.                                                                                                                                                                                                                     |

## The Recipient object (within the Payment Link object)

The Recipient object describes the bank account that receives the funds, returned in the `recipient_account` field when your organization uses Direct Payments in Chile.

| Attribute        | Type     | Description                                                                                                                                                                                                                       |
| ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `holder_id`      | `string` | Identifier of the account holder. In Chile, a Chilean tax ID (RUT); in Mexico, a Mexican tax ID (RFC) or unique population registry code (CURP).                                                                                  |
| `institution_id` | `string` | Account's institution `id`. You can learn more about institutions and their `id`s in [Payment initiation countries and institutions](/guides/payments/overview-payment-initiation/payment-initiation-countries-and-institutions). |
| `number`         | `string` | Account number. Does not include hyphens or prefixed zeros.                                                                                                                                                                       |
| `type`           | `string` | Account type. One of `checking_account` or `sight_account`.                                                                                                                                                                       |