Create a Fixed-Price Link {#paybylink-create-intro}
===================================================

Use the information in this section to create fixed-price links that you can send or display to your customers. Your customers can then use the links to pay on a secure `Visa Acceptance Solutions` hosted website.  
You can include discounts and taxes to either the total billed amount or to billed line items in a fixed-price link. For more information about including discounts and taxes to a fixed-price link, see [Optional Fields for Invoice Creation](/docs/vas/en-us/paybylink/developer/all/rest/paybylink/invoicing-services-create-opt-fields.md "").  
Fixed-price links are typically used by customers to make purchases. To create a link for donations, see [Create a Customer-Set Link](/docs/vas/en-us/paybylink/developer/all/rest/paybylink/paybylink-services/paybylink-create-customer-intro.md "").

Partner Information {#paybylink-create-intro_partner-info}
----------------------------------------------------------

If your merchant account is associated with a `Visa Acceptance Solutions` partner, you can include your partner solution ID (PSID) in the request for tracking and reporting purposes. To submit your PSID, include the clientReferenceInformation.partner.solutionId request field, and set its field value to your PSID.

Endpoints {#paybylink-create-intro_endpoint}
--------------------------------------------

**Production:** `POST ``https://api.visaacceptance.com``/ipl/v2/payment-links/`{#paybylink-create-intro_endpoint-create-prod}  
**Test:** `POST ``https://apitest.visaacceptance.com``/ipl/v2/payment-links/`{#paybylink-create-intro_endpoint-create-test}

Required Fields for Creating a Fixed-Price Link {#paybylink-create-req-fields}
==============================================================================

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.totalAmount
:

orderInformation.lineItems\[\].productName
:

orderInformation.lineItems\[\].unitPrice
:

processingInformation.linkType
:
Set to `PURCHASE`.

purchaseInformation.purchaseNumber
:
Set to a unique identifier for the fixed-price link.
{#paybylink-create-req-fields_payment-link}

Optional Fields for Creating a Fixed-Price Link {#paybylink-create-opt-fields}
==============================================================================

clientReferenceInformation.partner.developerId
:
Set to your developer ID.

clientReferenceInformation.partner.solutionId
:
Set to your partner solution ID (PSID).

invoiceInformation.transactionReferenceNumber
:

orderInformation.amountDetails.maxAmount
:

orderInformation.amountDetails.minAmount
:

orderInformation.lineItems\[\].productDescription
:

orderInformation.lineItems\[\].productSku
:

orderInformation.lineItems\[\].quantity
:

processingInformation.requestPhone
:

processingInformation.requestShipping
:

{#paybylink-create-opt-fields_opt-fields}

Optional Fields for Discounts and Taxes {#paybylink-create-opt-fields_tax-discount-fields}
------------------------------------------------------------------------------------------

**Discount Fields for the Link Total**

orderInformation.amountDetails.discountAmount
:

orderInformation.amountDetails.discountPercent
:

**Discount Fields for Line Items**

orderInformation.lineItems\[\].discountAmount
:

orderInformation.lineItems\[\].discountRate
:

**Tax Fields for Link Total**

orderInformation.lineItems\[\].discountAmount
:

orderInformation.lineItems\[\].discountRate
:

**Tax Fields for Line Items**

orderInformation.lineItems\[\].taxAmount
:

orderInformation.lineItems\[\].taxRate
:

{#paybylink-create-opt-fields_dl_vzp_1zz_hkc}

`REST` Example: Creating a Fixed-Price Link {#paybylink-create-ex-rest}
=======================================================================

Request

```
{
    "processingInformation": {
        "linkType": "PURCHASE"
    },
    "purchaseInformation": {
        "purchaseNumber": "78759658468578"
    },
    "orderInformation": {
        "amountDetails": {
            "currency": "USD",
            "totalAmount": "60"
        },
        "lineItems": [
            {
                "productName": "Birthday Cake",
                "unitPrice": "60"
            }
        ]
    }
}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/ipl/v2/payment-links/78795658468578",
      "method": "GET"
    },
    "update": {
      "href": "/ipl/v2/payment-links/78795658468578",
      "method": "PATCH"
    }
  },
  "id": "78795658468578",
  "submitTimeUtc": "2024-08-08T02:27:28.287601279Z",
  "status": "ACTIVE",
  "processingInformation": {
    "linkType": "PURCHASE",
    "requestPhone": false,
    "requestShipping": false
  },
  "purchaseInformation": {
    "purchaseNumber": "78795658468578",
    "createdDate": "2024-08-08T02:27:28.370",
    "paymentLink": "https://businesscenter.visaacceptance.com/payByLink/pay/IXBls1OJVqRiiv0SL8XjHit0InRBW844eEou2EWBCNP7WIGDdd8tjKN07Ep3MaQD"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 60,
      "currency": "USD"
    },
    "lineItems": [
      {
        "productName": "Birthday Cake",
        "unitPrice": 60,
        "quantity": 1
      }
    ]
  }
}
```