---
title: "Create payment Link"
method: POST
path: "/merchants/payments-links"
tags: ["Payment Links"]
---

# Create payment Link

`POST /merchants/payments-links`

Este endpoint permite crear un enlace de pago para asociarla a una o varias órdenes.

## Headers

- `X-API-KEY` string, required
- `x-merchant-id` string — Only needed if the Auth type is bearer token

## Request body

- PaymentLink
  - `checkout_modules` object[] — List of checkout modules
    - `name` string — Name of the checkout module
  - `configuration` object — Configuration settings
    - `expires_at` string — Expiration date and time (ISO 8601)
    - `max_completed_purchases` integer — Maximum number of completed purchases allowed
    - `max_payment_retries` integer — Maximum number of payment retries allowed
    - `payment_link_name` string — Name of the payment link
  - `order` object — Order details
    - `currency` string — Currency code (ISO 4217)
    - `is_paid` boolean — Whether the order is paid
    - `items` object[] — List of order items
      - `description` string — Item description
      - `id` string — Item ID
      - `image_url` string — URL of the item image
      - `name` string — Item name
      - `quantity` integer — Quantity of the item
      - `tax_amount` object
        - `currency` string — Currency code (ISO 4217)
        - `currency_symbol` string — Currency symbol
      - `total_amount` object
        - `amount` integer — Total amount of the item
        - `currency` string — Currency code (ISO 4217)
        - `currency_symbol` string — Currency symbol
        - `discount_amount` integer — Discount amount applied to the item
        - `original_amount` integer — Original amount of the item before discount
      - `unit_price` object
        - `amount` integer — Unit price of the item
        - `currency` string — Currency code (ISO 4217)
        - `currency_symbol` string — Currency symbol
    - `items_total_amount` number — Total amount of all items
    - `order_id` string — Unique order ID
    - `store_code` string — Store code
    - `sub_total` integer — Subtotal amount
    - `total_amount` integer — Total amount including tax
    - `total_tax_amount` integer — Total tax amount

## Response `200`

Payment link creada

- object
  - `configuration` object — Configuration settings
    - `expires_at` string — Expiration date and time (ISO 8601)
    - `max_completed_purchases` integer — Maximum number of completed purchases allowed
    - `max_payment_retries` integer — Maximum number of payment retries allowed
    - `payment_link_name` string — Name of the payment link
  - `order` object — Order details
    - `billing_address` object — Billing address
      - `email` string — Email address
    - `currency` string — Currency code (ISO 4217)
    - `items` object[] — List of order items
      - `description` string — Item description
      - `id` string — Item ID
      - `image_url` string — URL of the item image
      - `name` string — Item name
      - `quantity` integer — Quantity of the item
      - `tax_amount` object
        - `amount` integer — Tax amount
        - `currency` string — Currency code (ISO 4217)
        - `currency_symbol` string — Currency symbol
      - `total_amount` object
        - `amount` integer — Total amount of the item
        - `currency` string — Currency code (ISO 4217)
        - `currency_symbol` string — Currency symbol
        - `original_amount` integer — Original amount of the item before discount
        - `total_discount` integer — Total discount amount
      - `unit_price` object
        - `amount` integer — Unit price of the item
        - `currency` string — Currency code (ISO 4217)
        - `currency_symbol` string — Currency symbol
    - `items_total_amount` integer — Total amount of all items
    - `order_id` string — Unique order ID
    - `payer_info` unknown
    - `redirect_urls` object — Redirect URLs
      - `success` string — Success redirect URL
    - `store_code` string — Store code
    - `sub_total` integer — Subtotal amount
    - `total_amount` integer — Total amount including tax
    - `total_tax_amount` integer — Total tax amount
  - `payment_link` string — URL of the payment link
  - `payment_link_id` string — ID of the payment link

## Other responses

- `400` — Respuesta de un bad request
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/deuna/apis/user-network-api.md) · [All operations](https://skmtc.dev/deuna/apis/user-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuna/user-network-api/revisions/df73fa00ed05/schema)