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.

style

Sets the style of the payment forms. You can choose from "card", and "plain" style. Default is "card"

style: "card"

autofocus

Sets focus to the selected input/select element on the payment page upon loading

autofocus : 'card.holder'

onReady

Triggers when all payment forms are ready

onReady: function() {/* function here */};

requireCvv

Determines whether the CVV field is presented on the payment form.

requireCvv: false

allowEmptyCvv

Determines whether the CVV field can be empty. By default it is false

allowEmptyCvv: true

useSummaryPage

If set to true, the payment is not completed, instead the form will initiate a callback to the onSaveTransactionData function, which can initiate a redirection to a summary page. This summary page can then be used to summarise the checkout before asking the user to confirm. An example can be seen on our advanced options page.

useSummaryPage: true

onSaveTransactionData

Triggered after the shopper presses Continue on the CnP form, when useSummaryPage flag is set to true. Parameter "data" is the serialized data of the payment form.

onSaveTransactionData: function(data){console.log(data);}

threeDIframeSize

Sets size of the 3D secure iframe. This iframe will only be used in case a shopper has to enter 3D secure credentials on the bank's page.

iFrameSize: {width: 100%, height: 580px}

paymentTarget

We submit the form to this target. In case of additional shopper interaction, e.g. 3DSecure, we redirect the shopper within this target. This only works for card payment brands.

paymentTarget: 'my3dIframe'

shopperResultTarget

Works only in combination with "paymentTarget" option.
By default, we redirect the shopper to the given "shopperResultUrl" using a self-submitting form with target="_top". If you use COPYandPAY in an iframe and want to redirect the shopper within this iframe, then the "shopperResultTarget" and the "paymentTarget" should be the name of this iframe.

If set to true the CPF field on the COPYandPAY form will be displayed. The CPF field is needed for payments processed in Brazil.

showTaxNumberField: true

showCVVHint

If set to true then the credit card form will display a hint on where the CVV is located when the mouse is hovering over the CVV field.

showCVVHint: true

brandDetection

If the COPYandPAY form contains more than one credit card brand (e.g. MASTER VISA AMEX) and this option is set to true(default is false) then COPYandPAY updates the brand field automatically based on the first four digits entered in the credit card number field.

brandDetection: true

forceCardHolderEqualsBillingName

By default the card.holder is displayed as one field in COPYandPAY's form. If this option is set to true then the form displays a field for the given name and a separate field for the surname. The values entered here will be submitted both as card.holder and as customer.givenName and customer.surname.

Brand-Specific Parameters

Some brands also use very specific parameters in order to provide an appropriate user experience during checkout. The COPYandPAY API also allows you to customize these brand-specific parameters. Here you can find the reference on brand-specific parameters for wpwlOptions.

Parameter

Description

Example

KLARNA_INVOICE.fee

Sets the fee to be used for the "Billing agreement" link during a Klarna Invoice checkout. Default is 0.

KLARNA_INVOICE = {fee: 3.8}

KLARNA_INSTALLMENTS.fee

Sets the fee to be used for the "Read more" link during a Klarna Installments checkout. Default is 0.