Creating a Session

Create custom payment link ---- [auth scope: merchant]

post

Body

application/json

emailstringRequired

Hpp user email.

Example: [email protected]

pricenumberRequired

Hpp payment price

Example: 99.99

phoneNumberstringRequired

Hpp user phone number

Example: [phone]

descriptionstringRequired

Hpp payment description

Example: Payment for order #12345

currencystringRequired

Hpp payment currency

Example: USD

accountCodestringOptional

Hpp payment accountCode

Example: ACC123

invoiceNumberstringRequired

Hpp payment invoiceNumber

Example: INV-2025-0001

referenceNamestringRequired

Hpp payment referenceName

Example: Order #12345

dueDatestring · date-timeRequired

Hpp payment dueDate

Example: 2025-10-10T08:18:04.983Z

subTotalnumberRequired

Hpp payment subTotal

Example: 89.99

taxAmountnumberRequired

Hpp payment taxAmount

Example: 10

enableTippingbooleanRequired

Hpp payment enableTipping

Example: true

itemsstring[]Required

Hpp payment items

Example: [{"itemName":"Product A","sku":"SKU123","quantity":1,"price":89.99,"saveForFutureRef":false,"isTaxApplied":true,"appliedTaxes":[{"taxName":"VAT","taxRate":10,"taxAmount":9}]}]

hideTaxbooleanOptional

Hide Tax in order-summary on HPP

Example: false

emailCustomerbooleanOptional

Hpp payment emailCustomer

Example: true

Responses

200

Get Paid link created successfully.

application/json

post

/custom/hpp

HTTPcURLJavaScriptPython

POST /custom/hpp HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 529

{
  "email": "[email protected]",
  "price": 99.99,
  "phoneNumber": "[phone]",
  "description": "Payment for order #12345",
  "currency": "USD",
  "accountCode": "ACC123",
  "invoiceNumber": "INV-2025-0001",
  "referenceName": "Order #12345",
  "dueDate": "2025-10-10T08:18:04.983Z",
  "subTotal": 89.99,
  "taxAmount": 10,
  "enableTipping": true,
  "items": [
    {
      "itemName": "Product A",
      "sku": "SKU123",
      "quantity": 1,
      "price": 89.99,
      "saveForFutureRef": false,
      "isTaxApplied": true,
      "appliedTaxes": [
        {
          "taxName": "VAT",
          "taxRate": 10,
          "taxAmount": 9
        }
      ]
    }
  ],
  "hideTax": false,
  "emailCustomer": true
}

200

Get Paid link created successfully.

{
  "message": "text",
  "link": "text",
  "id": "text",
  "QRCodeImgUrl": "text"
}