Generate Payment Link from Invoice

Authorizations

requestToken

string

header

required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Headers

idempotencyKey

string

A unique ID you can include to prevent duplicating objects or transactions if a request is sent more than once. This key is not generated in Payabli, you must generate it yourself.

Path Parameters

idInvoice

integer

required

Invoice ID

Query Parameters

mail2

string

List of recipient email addresses. When there is more than one, separate them by a semicolon (;).

amountFixed

enum<string> | null

default:

true

Indicates whether customer can modify the payment amount. A value of true means the amount is not modifiable, a value false means the payor can modify the amount to pay.

Available options:

true,

false

Body

contactUs

object

ContactUs section of payment link page

contactUs.emailLabel

string | null

Custom content for email

contactUs.enabled

boolean

Toggles whether the section or element is enabled.

contactUs.header

string | null

Header text for section

contactUs.order

integer | null

Order of element or section in container.

Required range: x > 0

contactUs.paymentIcons

boolean

Flag indicating if icons for accepted card brands will be shown

contactUs.phoneLabel

string | null

Custom content for phone number

invoices

object

Invoices section of payment link page

invoices.enabled

boolean

Toggles whether the section or element is enabled.

invoices.invoiceLink

object

Link to invoice

invoices.invoiceLink.enabled

boolean

Toggles whether the section or element is enabled.

invoices.invoiceLink.label

string | null

Label to display for section or element

invoices.invoiceLink.order

integer | null

Order of element or section in container.

Required range: x > 0

invoices.order

integer | null

Order of element or section in container.

Required range: x > 0

invoices.viewInvoiceDetails

object

Link to view invoice details

invoices.viewInvoiceDetails.enabled

boolean

Toggles whether the section or element is enabled.

invoices.viewInvoiceDetails.label

string | null

Label to display for section or element

invoices.viewInvoiceDetails.order

integer | null

Order of element or section in container.

Required range: x > 0

logo

object

Logo section of payment link page

logo.enabled

boolean

Toggles whether the section or element is enabled.

logo.order

integer | null

Order of element or section in container.

Required range: x > 0

messageBeforePaying

object

Message section of payment link page

messageBeforePaying.enabled

boolean

Toggles whether the section or element is enabled.

messageBeforePaying.label

string | null

Label to display for section or element

messageBeforePaying.order

integer | null

Order of element or section in container.

Required range: x > 0

notes

object

Notes section of payment link page

notes.enabled

boolean

Toggles whether the section or element is enabled.

notes.header

string | null

Header text for section

notes.order

integer | null

Order of element or section in container.

Required range: x > 0

notes.placeholder

string | null

Placeholder text for input field

notes.value

string | null

Pre-populated value for input field

page

object

Page header section of payment link page

page.description

string | null

Page description in header

page.enabled

boolean

Toggles whether the section or element is enabled.

page.header

string | null

Page header

page.order

integer | null

Order of element or section in container.

Required range: x > 0

paymentButton

object

Payment button section of payment link page

paymentButton.enabled

boolean

Toggles whether the section or element is enabled.

paymentButton.label

string | null

Label to display for section or element

paymentButton.order

integer | null

Order of element or section in container.

Required range: x > 0

paymentMethods

object

Payment methods section of payment link page

paymentMethods.allMethodsChecked

boolean

Flag indicating if all allowed payment methods will be pre-selected.

paymentMethods.enabled

boolean

Toggles whether the section or element is enabled.

paymentMethods.header

string | null

Header text for section

paymentMethods.methods

object

paymentMethods.methods.amex

boolean

When true, American Express is accepted.

paymentMethods.methods.applePay

boolean

When true, Apple Pay is accepted.

paymentMethods.methods.discover

boolean

When true, Discover is accepted.

paymentMethods.methods.eCheck

boolean

When true, ACH is accepted.

paymentMethods.methods.mastercard

boolean

When true, Mastercard is accepted.

paymentMethods.methods.visa

boolean

When true, Visa is accepted.

paymentMethods.order

integer | null

Order of element or section in container.

Required range: x > 0

paymentMethods.settings

object

Settings for wallet payment methods.

paymentMethods.settings.applePay

object

paymentMethods.settings.applePay.buttonStyle

enum<string>

default:

black

The Apple Pay button style. See Apple Pay Button Style for more information.

Available options:

black,

white-outline,

white

paymentMethods.settings.applePay.buttonType

enum<string>

default:

pay

The text on Apple Pay button. See Apple Pay Button Type for more information.

Available options:

plain,

buy,

donate,

check-out,

book,

continue,

top-up,

order,

rent,

support,

contribute,

tip,

pay

paymentMethods.settings.applePay.language

enum<string>

default:

en-US

The Apple Pay button locale. See Apple Pay Button Language for more information.

Available options:

en-US,

ar-AB,

ca-ES,

zh-CN,

zh-HK,

zh-TW,

hr-HR,

cs-CZ,

da-DK,

de-DE,

nl-NL,

en-AU,

en-GB,

fi-FI,

fr-CA,

fr-FR,

el-GR,

he-IL,

hi-IN,

hu-HU,

id-ID,

it-IT,

ja-JP,

ko-KR,

ms-MY,

nb-NO,

pl-PL,

pt-BR,

pt-PT,

ro-RO,

ru-RU,

sk-SK,

es-MX,

es-ES,

sv-SE,

th-TH,

tr-TR,

uk-UA,

vi-VN

payor

object

Customer/Payor section of payment link page

payor.enabled

boolean

Toggles whether the section or element is enabled.

payor.fields

object[] | null

Array of Customer/Payor fields to show in section

payor.fields.display

boolean

Flag indicating if the input field will show in container

payor.fields.fixed

boolean

Flag indicating if the value in input field is readonly or not

payor.fields.identifier

boolean

Flag indicating if the input field is a customer identifier

payor.fields.label

string | null

Label to display for field

payor.fields.name

string | null

Name of field to show Should be one of the standard customer fields or a custom field name

payor.fields.order

integer | null

Order of element or section in container.

Required range: x > 0

payor.fields.required

boolean

Flag indicating if the input field is required for validation

payor.fields.validation

string | null

Type of validation to apply to the input field Accepted values:

alpha for alphabetic, - numbers for numeric, - text for alphanumeric, - email for masked email address input, - phone for US phone numbers

payor.fields.value

string | null

Pre-populated value for field

payor.fields.width

enum<integer>

Numeric value indicating the size of input relative to the container Accepted values:

4 = 1/3, - 6 = 1/2, - 8 = 2/3, - 12 = 3/3

Available options:

4,

6,

8,

12

payor.header

string | null

Custom header text for section

payor.order

integer | null

Order of element or section in container.

Required range: x > 0

review

object

Review section of payment link page

review.enabled

boolean

Toggles whether the section or element is enabled.

review.header

string | null

Header text for section

review.order

integer | null

Order of element or section in container.

Required range: x > 0

settings

object

Settings section of payment link page

settings.color

string | null

An HTML color code in format #RRGGBB

settings.customCssUrl

string | null

Complete URL to a custom CSS file to be loaded with the page

settings.language

string | null

Two-letter code following ISO 639-1

settings.pageLogo

object

Object containing logo file to upload/ use in page

settings.pageLogo.fContent

string | null

Content of file, Base64-encoded Ignored if furl is specified. Max upload size is 30 MB.

settings.pageLogo.filename

string | null

The name of the attached file.

settings.pageLogo.ftype

enum<string> | null

The MIME type of the file (if content is provided)

Available options:

pdf,

doc,

docx,

jpg,

jpeg,

png,

gif,

txt

settings.pageLogo.furl

string | null

Optional url provided to show or download the file remotely

settings.redirectAfterApprove

boolean

Flag indicating if the capability for redirection in the page will be activated

settings.redirectAfterApproveUrl

string | null

Complete URL where the page will be redirected after completion

Response

200 - application/json

isSuccess

boolean

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

responseData

string

If isSuccess = true, this contains the payment link identifier. If isSuccess = false, this contains the reason of the error.

responseText

string | null

Response text for operation: 'Success' or 'Declined'.

API Basics

Pay In Endpoints

Pay Out Endpoints

Pay Ops Endpoints

Object Models

Generate Payment Link from Invoice

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response