Pay by Link API

Pay by Link API enables you to further customize your checkout workflows.  Here you can find the reference for the available options


Parameter Description Examples
locale

Sets the language/country of the payment forms. Expects ISO 639-1 for languages and ISO 3166-1 alpha-2 for countries. Default is "en-US".

Supported languages are: ar,be,bg,cn,cz,de,da,el,en,es,fi,fr,gr,hu,it,ja,ko,nl,no,pl,pt,ro,ru,sv,sk,sl,tr

Right-to-left languages are not supported by the number formatter.

locale: "de-AT"

locale: "de"

Check the requirements of the connector you are integrating in your shop. If the connector requires to have the language and the country provided, use the format "de-AT". If there is no requirement defined, you may use any of the two options.

validUntil

Sets the period during which the payment link will be valid and available to perform a checkout.

If validity period is not present default value will be 90 days

validUntil=1

validUntilUnit

Sets the validity period units. Possible values are HOUR, DAY.

validUntilUnit=HOUR

termsAndConditionsUrl

Merchant terms and conditions URL. Value must be a valid URL

termsAndConditionsUrl=https://test.docs.oppwa.com/

privacyPolicyUrl

Merchant privacy policy URL. Value must be a valid URL

privacyPolicyUrl=https://test.docs.oppwa.com/

wpwlOptions

Used to customize the behavior of the embedded COPYandPAY in the page. Note that not all the options are available. The list of available options is listed in the Available wpwlOptions table.

wpwlOptions={"labels":{"cardHolder":"Name on card"}}

collectBilling

Used to collect billing information from the page. It accepts a comma separated string of pre-defined values. Available values are: street1,street2,houseNumber1,houseNumber2,city,state,postcode,country,all. Depending on which value is sent, the form will render accordingly. If all is sent, the full form is rendered.

collectBilling=postcode

mandatoryBilling

Used in conjuntion with collectBiiling, makes the specified input field in the billing form mandatory. Available values are: street1,street2,houseNumber1,houseNumber2,city,state,postcode,country,all.

Except when using all, a javascript regular expression can be specified to validate each field. This feature can be implemented as follows: city,postcode:/^[a-z]{2}[0-9]{5}$/i,street1. Here postcode would have to be 2 letters (upper or lower case) followed by 5 numbers. The fields city and street1 can not be empty. As the fields country and state are drop down selections, any regular expression defined for these will be ignored but if specified a value must be selected.

mandatoryBilling=postcode

billing.*

The billing address field can be used to show billing information on the page. If used together with collectBiiling, it can be used to pre-fill the billing form.

billing.postecode=81675

customer.phone

Used to show the customer phone number on the page.

customer.phone=+491546556745

customer.email

Used to show the customer email on the page.

customer.email=john.doe@email.com

enableSinglePayButton

When enabled the page will display one pay button for all the payment methods

enableSinglePayButton=true

Layout Parameters

Layout Parameters used to customize payment page appearance

Parameter Description Examples
layout.logo

URL of merchant store logo which may be displayed on payment page.

layout.logoWidth

Merchant store logo's width. By default value is 150px

layout.logoWidth=300

layout.logoHeight

Merchant store logo's height. By default value is 100px

layout.logoWidth=200

layout.backgroundImage

URL of image which will be used as a background for payment page

layout.merchantNameColor

The color of merchant name label's specified in hexadecimal format. By default value is #6b6b6b

#ffffff

layout.amountColor

The color of amount and price labels specified in hexadecimal format. By default value is #00000

#ffffff

layout.payButtonColor

The background color of Pay Now button. By default value is #5cb85c

#ffffff

layout.payButtonTextColor

The color of Pay Now button's text. By default value is #ffffff

#ffffff

Extended Layout Parameters (JSON)

This parameter is similar to the parameters described in the Layout Parameters section but with more options for configuration. The Extended Layout Parameters are a superset of the parameters presented in the Layout Parameters section. The parameter name for sending the Extended Layout Parameters is layout.template and the value of this parameter is in JSON format. Below are described the main keys which can be sent in the JSON structure. Check the sample file to see the JSON structure containing the full list of parameters. It's not mandatory to send all the parameters presented in the JSON file, but only the ones needed to configure the UI elements differently than the default behavior.

Parameter Description Examples
body/background-image

The background image of the whole payment page.

https://image.com/my-image.jpg

body/background-color

The background color of the whole payment page specified according HTML/CSS standard.

#FF6666, red, etc.

body/width

The width occupied by the whole payment page specified according HTML/CSS standard.

80%, 800px, 80vw

body/height

The height occupied by the whole payment page specified according HTML/CSS standard.

80%, 800px, 80vh

body/leftPanelObjects

The elements and their order which should be displayed on the left side of the payment page.
The presence of totalAmount and paymentMethods is mandatory either on left or right side.

logo, merchantName, totalAmount, cartItems, billing, paymentMethods, terms, cancelPayment, contactInfo, shipping

body/rightPanelObjects

The elements and their order which should be displayed on the right side of the payment page.
The presence of totalAmount and paymentMethods is mandatory either on left or right side.

logo, merchantName, totalAmount, cartItems, billing, paymentMethods, terms, cancelPayment, contactInfo, shipping

body/leftPanel

Configure the following properties of the left side of the payment page: background-image, background-color, width, subelement-alignment. It is possible to specify the width of the elements (pixels or percents) and their alignment within the left container.

See sample file.

body/rightPanel

Configure the following properties of the right side of the payment page: background-image, background-color, width, subelement-alignment. It is possible to specify the width of the elements (pixels or percents) and their alignment within the right container.

See sample file.

logo/subTitle

Bellow the logo image a sub title can be added with configurable font style.

See sample file.

logo/imageParameters

Configure the logo image properties like width, height, alt and src.

See sample file.

merchantName/name

Configure the merchant name styling specified in the merchant.name parameter.

See sample file.

merchantName/orderId

Configure the order ID styling specified in the merchantTransactionId parameter.

See sample file.

totalAmount/prefixLabel

The total amount value can be prefixed with a text and it is possible to configure the styling of the text.

See sample file.

totalAmount/amount

Change the styling of the total amount value.

See sample file.

totalAmount/subTitle

A sub title can be added bellow total amount value and the styling of it can be configured.

See sample file.

cartItems

Configure the styling of the cart items sent in the cart.items* parameters.

See sample file.

paymentMethods/title

Configure a title for the payment widget and its styling.

See sample file.

paymentMethods/subTitle

Configure a sub title for the payment widget and its styling.

See sample file.

paymentMethods/paymentMethodList

Configure the text and styling which prefix the payment methods listed in the payment methods widget. The paymentMethodList contains a list of payment methods each with its own text and styling. Each payment method is identified by a "key" which is predefined. The valid IDs of the payment methods can be found here.

See sample file.

payButton

Configure the text and its styling appearing on the pay button. The background color is also configurable for the pay button.

See sample file.

payButton

Configure the text and its styling appearing on the pay button. The background and the border is also configurable for the pay button.

See sample file.

terms

Configure the styling of the text label for the terms and conditions checkbox.

See sample file.

cancelButton/cancelResultUrl

The URL where the user is redirected after canceling the payment.

Any valid URL.

cancelButton/type

Display a link or a button for canceling the payment.

"type": "button" or "type": "link".

cancelButton/buttonBackgroundColor

Configure the background color if the type is button.

#FF6666, red, etc.

cancelButton/linkAlignment

Configure the alignemnt of the text if the type is link.

left, right or center.

cancelButton/wording

Configure the text and styling for the cancel payment link/button.

See sample file.

contactInfo/title

Configure the text and styling for title of the contact information section.

See sample file.

contactInfo/subTitle

Configure the text and styling for sub title of the contact information section.

See sample file.

contactInfo/email

Configure the label and text styling for the input field used for the customer's email address.

See sample file.

shipping/oneLineFormatting

When this configuration option is present, the shipping address will be displayed on 1 line, so street name, house number, etc. will not be displayed on separate lines as it is done by default. This option also configures the label and text style for displaying the shipping address.

See sample file.

shipping/order

Define the address elements and their order for specifying the shipping address.

Possible values: houseNumber1, street1, postcode, city, country.

shipping/title

Configure the title for the shipping section and the styling of the text.

See sample file.

shipping/subTitle

Configure the sub title for the shipping section and the styling of the text.

See sample file.

shipping/address

Configure the labels and text styling for shipping address elements. The available address items are: houseNumber1, street1, postcode, city, country.

See sample file.

billing/oneLineFormatting

When this configuration option is present, the shipping address will be displayed on 1 line, so street name, house number, etc. will not be displayed on separate lines as it is done by default. This option also configures the label and text style for displaying the shipping address. Note that 1 line formatting is not available if collectBilling parameter is present.

See sample file.

billing/order

Define the address elements and their order for specifying the shipping address.

Possible values: houseNumber1, street1, street2, postcode, city, country.

billing/title

Configure the title for the shipping section and the styling of the text.

See sample file.

billing/subTitle

Configure the sub title for the shipping section and the styling of the text.

See sample file.

billing/address

Configure the labels and text styling for shipping address elements. The available address items are: houseNumber1, street1, street2, postcode, city, country.

See sample file.

Send link to shopper via SMS

These paramerets used to control SMS content

Parameter Description Examples
from

Free-form text with which the sender identifies themselves to the recipient. Must not exceed 11 characters length.

from=MTS

smsTo

The number to which the message is sent. Numbers are specified in E.164 format.

smsTo=14049236100

Available wpwlOptions

To know more about the options, refer to COPYandPAY API
Name
threeDIframeSize
numberFormatting
bancontactQr
upgQr
requireCvv
allowEmptyCvv
maskCvv
brandDetection
brandDetectionType
autofocus
validation
validateCard
validateDirectDebit
validateOnlineTransfer
validateVirtualAccount
validatePrepayment
validateInvoice
validateOnDelivery
spinner
disableCardExpiryDateValidation
forceCardHolderEqualsBillingName
showCVVHint
iframeStyles
displayIban
displayBic
showLabels
showPlaceholders
labels
placeholders
errorMessages
applePay
googlePay
paypal
brandDetectionPriority
brandDisplay
inlineFlow
showBirthDate
disableSubmitOnEnter
styling
fundingSources
showBirthDate
showBillingAgreement