Customization

 Quick links
​Style Options​
​Language Options​
​Brand Options​
​CSS Reference​
You can customize the look and feel of the COPYandPAY payment form using the options below.
html
css
js
result
Example Custom Style
Example Card Style
Example  Plain Style
Example Default
1
<form action="https://allpago.docs.oppwa.com/tutorials/integration-guide/customisation" class="paymentWidgets" data-brands="VISA MASTER AMEX"></form>
Copied!
1
body {background-color:#f6f6f5;}
Copied!
1
var wpwlOptions = {style:"card"}
Copied!
css
1
    .cnpBillingCheckoutWrapper {position:relative;}
2
    .cnpBillingCheckoutHeader {width:100%;border-bottom: 1px solid #c0c0c0;margin-bottom:10px;}
3
    .cnpBillingCheckoutLeft {width:240px;margin-left: 5px;margin-bottom: 10px;border: 1px solid #c0c0c0;display:inline-block;vertical-align: top;padding:10px;}
4
    .cnpBillingCheckoutRight {width:50%;margin-left: 5px;border: 1px solid #c0c0c0;display:inline-block;vertical-align: top;padding:10px;}
5
    .cnpBillingCheckoutOrange {font-size:110%;color: rgb(255, 60, 22);font-weight:bold;}
6
    div.wpwl-wrapper, div.wpwl-label, div.wpwl-sup-wrapper { width: 100% }
7
    div.wpwl-group-expiry, div.wpwl-group-brand { width: 30%; float:left }
8
    div.wpwl-group-cvv { width: 68%; float:left; margin-left:2% }
9
    div.wpwl-group-cardHolder, div.wpwl-sup-wrapper-street1, div.wpwl-group-expiry { clear:both }
10
    div.wpwl-sup-wrapper-street1 { padding-top: 1px }
11
    div.wpwl-wrapper-brand { width: auto }
12
    div.wpwl-sup-wrapper-state, div.wpwl-sup-wrapper-city { width:32%;float:left;margin-right:2% }
13
    div.wpwl-sup-wrapper-postcode { width:32%;float:left }
14
    div.wpwl-sup-wrapper-country { width: 66% }
15
    div.wpwl-wrapper-brand, div.wpwl-label-brand, div.wpwl-brand { display: none;}
16
    div.wpwl-group-cardNumber { width:60%; float:left; font-size: 20px;  }
17
    div.wpwl-group-brand { width:35%; float:left; margin-top:28px }
18
    div.wpwl-brand-card  { width: 65px }
19
    div.wpwl-brand-custom  { margin: 0px 5px; background-image: url("https://oppwa.com/v1/paymentWidgets/img/brand.png") }
20
​
Copied!
js
1
var wpwlOptions = {
2
      style: "plain",
3
      billingAddress: {
4
        country: "US",
5
        state: "NY",
6
        city: "New York",
7
        street1: "111 6th Avenu",
8
        street2: "",
9
        postcode: "12312"
10
      },
11
      forceCardHolderEqualsBillingName: true,
12
      showCVVHint: true,
13
      brandDetection: true,
14
      onReady: function(){ 
15
        $(".wpwl-group-cardNumber").after($(".wpwl-group-brand").detach());
16
        $(".wpwl-group-cvv").after( $(".wpwl-group-cardHolder").detach());
17
        var visa = $(".wpwl-brand:first").clone().removeAttr("class").attr("class", "wpwl-brand-card wpwl-brand-custom wpwl-brand-VISA")
18
        var master = $(visa).clone().removeClass("wpwl-brand-VISA").addClass("wpwl-brand-MASTER");
19
        $(".wpwl-brand:first").after( $(master)).after( $(visa));
20
      },
21
      onChangeBrand: function(e){
22
        $(".wpwl-brand-custom").css("opacity", "0.3");
23
        $(".wpwl-brand-" + e).css("opacity", "1"); 
24
      }
25
    }
Copied!
css
1
body {background-color:#8e44ad;}
Copied!
js
1
var wpwlOptions = {style:"card"}
Copied!
css
1
body {background-color:#16a085;}
Copied!
js
1
var wpwlOptions = {style:"plain"}
Copied!
css
1
body {background-color:#f6f6f5;}
Copied!
js
1
var wpwlOptions = {style:"card"}
Copied!
 Click here for Mozilla's CSS reference guide​
Style Options
The style of the payment form can be changed by setting the style option in the wpwlOption object before the payment widget is loaded. Valid options are:
plain
card
1
<script>
2
    var wpwlOptions = {
3
        style: "card"
4
    }
5
</script>
6
<script async src="https://test.oppwa.com/v1/paymentWidgets.js?checkoutId={checkoutId}"></script>
Copied!
Card Number and CVV placeholder styles
 In order to change the style of the placeholders inside card-number and cvv, please use the option iframeStyle, according to the example below:
1
<script>
2
var wpwlOptions = {
3
    iframeStyles: {
4
        'card-number-placeholder': {
5
            'color': '#ff0000',
6
            'font-size': '16px',
7
            'font-family': 'monospace'
8
        },
9
            'cvv-placeholder': {
10
            'color': '#0000ff',
11
                'font-size': '16px',
12
                'font-family': 'Arial'
13
        }
14
    }
15
}</script>
16
<script async src="https://test.oppwa.com/v1/paymentWidgets.js?checkoutId={checkoutId}"></script>
Copied!
 (Please note that only Web Safe fonts are supported)
Language Options
The language of the labels on the payment form can be changed by setting the locale option in the wpwlOption object before the payment widget is loaded.
1
<script>
2
    var wpwlOptions = {
3
        locale: "en"
4
    }
5
</script>
6
<script async src="https://test.oppwa.com/v1/paymentWidgets.js?checkoutId={checkoutId}"></script>
Copied!
Brands Options
Payment options can be selected manually by entering the options in the <form> tag.
1
<form action="" class="paymentWidgets" data-brands="VISA MASTER"></form>
Copied!
CSS Reference
As you have seen above, you can override any of the form's CSS simply by adding custom CSS in your stylesheet. For advanced style we recommend using a default style of plain, however custom stylesheets can be combined with any of the default style options.
Base CSS Classes
For performance reasons, all elements have a base CSS class and individual CSS class, e.g. the credit card payment form container has a base .wpwl-container class and an individual .wpwl-container-card class to specify the card payment form container.
Container
.wpwl-container wraps the payment form. Use this to apply, for example, margins between your page elements and the payment form.
1
<div class="wpwl-container">
2
    ...
3
</div>
Copied!
Individual classes:
.wpwl-container-card
Form
.wpwl-form styles all payment forms. Use this to change the look and feel of the payment form, including backgrounds or shadows.
1
<form class="wpwl-form wpwl-clearfix" action="https://test.oppwa.com/v1/checkouts/{checkoutId}/payment" method="POST" target="cnpIframe" lang="en">
2
    ...
3
</form>
Copied!
Individual classes:
.wpwl-form-card
Groups
.wpwl-group wraps the label and the wrapper of the input element. Use this to style labels and inputs together, i.e. position or width. 
1
<div class="wpwl-group">
2
    <div class="wpwl-label">...</div>
3
    <div class="wpwl-wrapper">...</div>
4
</div>
Copied!
Individual classes:
.wpwl-group-brand 
.wpwl-group-cardNumber 
.wpwl-group-expiry 
.wpwl-group-cardHolder 
.wpwl-group-cvv 
.wpwl-group-submit styles the ""Pay now" button.
.wpwl-group-button styles the buttons containing the brand
Labels
.wpwl-label holds the label of an input element.
1
<div class="wpwl-label">
2
    Card Number
3
</div>
Copied!
Individual classes:
.wpwl-label-brand
.wpwl-label-cardNumber
.wpwl-label-expiry
.wpwl-label-cardHolder
.wpwl-label-cvv
Input and Select Wrappers
Input and select elements are wrapped in a div to gain more control over their styles, especially their width. 
.wpwl-wrapper holds an input or select element. Use this to set the width of the containing input or select element.
1
<div class="wpwl-wrapper">
2
    ...
3
</div>
Copied!
Individual classes:
.wpwl-wrapper-brand 
.wpwl-wrapper-cardNumber 
.wpwl-wrapper-expiry 
.wpwl-wrapper-cardHolder 
.wpwl-wrapper-cvv 
.wpwl-wrapper-submit 
Input and Select Elements
All textual <input>, <textarea>, and <select> elements have a base .wpwl-control class and are set to width: 100%; by default.  The width of these elements should be set via .wpwl-wrapper.
.wpwl-control styles the borders, backgrounds or paddings of all <input> and <select> elements. 
1
<input class="wpwl-control wpwl-control-cardNumber" name="card.number" autocomplete="off" type="tel" placeholder="Card Number">
Copied!
1
<select class="wpwl-control wpwl-control-brand" name="paymentBrand">
2
    <option value="MASTER">Mastercard</option>
3
    <option value="VISA">Visa</option>
4
</select>
Copied!
Individual classes:
.wpwl-control-brand 
.wpwl-control-cardNumber 
.wpwl-control-expiry 
.wpwl-control-cardHolder 
.wpwl-control-cvv  
Buttons
.wpwl-button styles the submit buttons.
1
<button type="submit" name="pay" class="wpwl-button wpwl-button-pay">Pay now</button>
Copied!
Individual classes:
.wpwl-button-pay styles the "Pay now" button.
.wpwl-button-brand styles the buttons containing a brand.
Brands
.wpwl-brand styles the brand icons.
1
<div class="wpwl-brand wpwl-brand-MASTER"></div>
Copied!
Individual classes:
.wpwl-brand-card styles the card brands
.wpwl-brand-BRAND styles the specific brand.
Error Hints
.wpwl-has-error adds a red background, border and color to the input element and a red color to the next .wpwl-hint element.
1
<input autocomplete="off" type="tel" name="card.number" class="wpwl-control wpwl-control-cardNumber wpwl-has-error" placeholder="Card Number">
2
<div class="wpwl-hint wpwl-hint-cardNumberError">
3
    Invalid card number or brand
4
</div>
Copied!
Individual classes:
.wpwl-hint-cardNumberError
.wpwl-hint-expiryError
.wpwl-hint-cardHolderError
.wpwl-hint-cvvError
Helpers
.wpwl-clearfix allows elements to contain floats without re-sorting. Assuming that .wpwl-label and .wpwl-wrapper are floated, .wpwl-group needs .wpwl-clearfix.
1
<div class="wpwl-group wpwl-clearfix">
2
    <div class="wpwl-label">...</div>
3
    <div class="wpwl-wrapper">...</div>
4
</div>
Copied!
Credit Card HTML and CSS Classes
Here is an example HTML output of the credit card payment form:
1
<div id="card_220921339056" class="wpwl-container wpwl-container-card">
2
    <form class="wpwl-form wpwl-form-card wpwl-clearfix" action="https://test.oppwa.com/v1/checkouts/{checkoutId}/payment" method="POST" target="cnpIframe" lang="en">
3
        <div class="wpwl-group wpwl-group-brand wpwl-clearfix">
4
            <div class="wpwl-label wpwl-label-brand">Brand</div>
5
            <div class="wpwl-wrapper wpwl-wrapper-brand">
6
                <select class="wpwl-control wpwl-control-brand" name="paymentBrand">
7
                    <option value="MASTER">Mastercard</option>
8
                    <option value="VISA">Visa</option>
9
                </select>
10
            </div>
11
            <div class="wpwl-brand wpwl-brand-card wpwl-brand-MASTER"></div>
12
        </div>
13
        <div class="wpwl-group wpwl-group-cardNumber wpwl-clearfix">
14
            <div class="wpwl-label wpwl-label-cardNumber">Card Number</div>
15
            <div class="wpwl-wrapper wpwl-wrapper-cardNumber">
16
                <input autocomplete="off" type="tel" name="card.number" class="wpwl-control wpwl-control-cardNumber" placeholder="Card Number">
17
            </div>a
18
        </div>
19
        <div class="wpwl-group wpwl-group-expiry wpwl-clearfix">
20
            <div class="wpwl-label wpwl-label-expiry">Expiry Date</div>
21
            <div class="wpwl-wrapper wpwl-wrapper-expiry">
22
                <input autocomplete="off" type="tel" name="card.expiry"b class="wpwl-control wpwl-control-expiry" placeholder="MM / YY">
23
            </div>
24
        </div>
25
        <div class="wpwl-group wpwl-group-cardHolder wpwl-clearfix">
26
            <div class="wpwl-label wpwl-label-cardHolder">Card holder</div>
27
            <div class="wpwl-wrapper wpwl-wrapper-cardHolder">
28
                <input autocomplete="off" type="text" name="card.holder" class="wpwl-control wpwl-control-cardHolder" placeholder="Card holder">
29
            </div>
30
        </div>
31
        <div class="wpwl-group wpwl-group-cvv wpwl-clearfix">
32
            <div class="wpwl-label wpwl-label-cvv">CVV</div>
33
            <div class="wpwl-wrapper wpwl-wrapper-cvv">
34
                <input autocomplete="off" type="tel" name="card.cvv" class="wpwl-control wpwl-control-cvv" placeholder="CVV">
35
            </div>
36
        </div>
37
        <div class="wpwl-group wpwl-group-submit wpwl-clearfix">
38
            <div class="wpwl-wrapper wpwl-wrapper-submit">
39
                <button type="submit" name="pay" class="wpwl-button wpwl-button-pay">Pay now</button>
40
            </div>
41
        </div>
42
        <input type="hidden" name="shopperResultUrl" value="https://test.oppwa.com/v1/checkouts/{checkoutId}/payment">
43
        <input type="hidden" name="card.expiryMonth" value="">
44
        <input type="hidden" name="card.expiryYear" value="">
45
    </form>
46
</div>
Copied!
Integration guide - Previous
COPYandPAY
Advanced Options
Last modified 2yr ago
Copy link
Contents
Quick links
Style Options
Card Number and CVV placeholder styles
Language Options
Brands Options
CSS Reference
Credit Card HTML and CSS Classes