BuyNow Parameters

BuyNow parameters are values that can be included within the URL of your Hosted Payment or Hosted Checkout page. You can use these parameters to add, update, and customize fields on the page.

For example, if you would like the checkout page to always appear in Danish and show the currency in Euros, regardless of where the shopper's IP address is located, you can include the language and currency parameters in the URL as follows:

https://checkout.bluesnap.com/buynow/checkout?sku2269659=1&storeid=17125&language=DANISH&currency=EUR

For more information about how to use these parameters, see Dynamic checkout customization with parameters.

Override price

If you would like to override the price that appears on the checkout page, use the override price capability, which is based on an encrypted parameter.

BuyNow general parameters

Some of the frequently used parameters include:

  • Use the quantity parameters to display the number of units of a given contract to add to the order
  • Use the store id parameter to dynamically assign a specific template associated with the merchant
  • Use the coupon code parameter to pre-populate the coupon code field with the relative code
  • Use the promotion parameters to add additional items to the order page
Parameter
Type
Description
Example

backtosellervisible

Y/N

Defines whether the "Continue" button appears on the Thank You page

Y

browsertitle

string

Defines the title of the browser page, which appear in the browser tab

Checkout

browsertitlevisible

Y/N

Defines whether the title of the browser page is visible

Y

cart.addcd

Y/N

Should the CD be added to the cart by default (default: N)

Y

cart.open

Y/N

When set to Y, the cart on the mobile skin is expanded by default upon loading.

Y

cartvisible

Y/N

Indicates if the shopping cart is visible. Y – visible (default: Y)

Y

cdodvisible

Y/N

Indicates if CD on demand component is visible

Y

companylogovisible

Y/N

Defines whether the company logo is visible

Y

couponboxvisible

Y/N

Indicates if the coupon code/gift certificate box is visible. Y – visible (default: Y, if the shopper is allowed to add an additional coupon)

Y

couponcode

string

Coupon to be used in the purchase

CyberMonday

currency

3 letter code according to ISO 4217 (case-insensitive)

Currency to display on the order page

EUR

currencyvisible

Y/N

Indicates if the shopper currency preference field is visible. Y – visible (default: Y)

Y

currencydisable

Y/N

Indicates if the shopper currency preference field is disabled. Y - Disabled (default:N)

Y

custom.[#]

Y/N

Indicates whether the specified custom parameter will be displayed

custom2=Y

custom[#].sku.[contract ID]

string

Sets the value for the specified custom parameter, for the specified contract only

custom.4903.sku.2131313=’Red’

edwvisible

Y/N

Indicates of the EDW component is visible

Y

forceDesktop

Y/N

Indicates whether to force the desktop skin to display, regardless of the shopper's device

Y

forceMobile

Y/N

Indicates whether to force the mobile skin to display, regardless of the shopper's device

Y

language

ALBANIAN
ARABIC
BRAZILIAN
BULGARIAN
CZECH
DANISH
DUTCH
ENGLISH
FINNISH
FRENCH
GERMAN
HEBREW
HUNGARIAN
ITALIAN
JAPANESE
KOREAN
LITHUANIAN
NORWEGIAN
POLISH
PORTUGUESE
RUSSIAN
SERBIAN
SLOVAK
SPANISH
SWEDISH
TURKISH

Language

DANISH

languagevisible

Y/N

Indicates if the shopper language preference field is visible. Y – visible (default: Y)

Y

languagedisable

Y/N

Indicates if the shopper language preference field is disabled. Y - Disabled (default:N)

Y

merchanttransactionid
or
merchant.transaction.id

string

Unique ID that the merchant assigns to the transaction/order, up to 50 characters.

1000

promotionsvisible

Y/N

Indicates if promotional items are visible. (default: Y, if promotional items exist)

Y

referrer

integer

For affiliation: the affiliate ID

123585

resellerModel

Litle

Defines whether to display reseller model formatting on the checkout page
Enter Litle to display reseller formatting

resellerModel=Litle

scid

integer

Shopping context ID

12344542

sealmcafeevisible

Y/N

Defines whether the McAfee secure seal is visible

Y

sealverisignvisible

Y/N

Defines whether the Verisign secure seal is visible

Y

sealvisible

Y/N

Defines whether the secure seal is visible

Y

sellerorderid
or
seller.order.id

string

Unique ID that the merchant assigns to the transaction/order, up to 50 characters.

1000

shoppingcarttotalvisible

Y/N

Indicates if the shopping cart total is visible. Y – visible (default: Y)

Y

showupsaleprices

Y/N

Indicates if sale prices are shown up (default: Y)

Y

skinId

integer

ID of the skin to apply to the page

11003

sku[contractID]=#

integer

Quantity of the item (or promotional item) to be purchased

sku123456=3

sku[contract ID]ald

Y/N

Y - Allow the shopper to remove this SKU from the cart's promotional items (default)

N- Remove the delete item button from the order page

sku1666864ald=N

sku[contract ID]name

string

Override this SKU to have the name given as the parameter value.

sku1471485name=cocacola

skuimagevisible

Y/N

Defines whether the contract's image is visible

Y

softdesc

string

Soft descriptor that should appear on the shopper’s card bill

Pizza House Inc

storeid

integer

Store ID

155

submitvisible

Y/N

Indicates whether the submit button is visible

Y

testMode

Y/N

Indicates whether this is a test of the BuyNow flow

Y

tid

string

For affiliation: the transaction ID

12345

upsalevisible

Y/N

Indicates if the up sales component is visible. Y – visible (default: Y, if up sales items exist)

N

Payment options

Activate payment methods in the console

Before the following payment option parameters can be used, the payment methods you intend to use must be enabled to “Show” in the console.

You can use these parameters to offer specific payment methods.

Parameter
Type
Description
Example

payment[paymentMethod]

String in the format:
payment[paymentMethod]=Y/N

Payment method
Available values:
cc
paypal
moneybookers
skrill
webmoney
wire

payment{cc}=Y

paymentmethodsvisible

Y/N

Indicates if the payment options widget is visible

N

alipay

Y/N

Defines whether shoppers can pay with Alipay

N

banktransfer

Y/N

Defines whether shoppers can pay with local bank transfer

N

boletoBancario

Y/N

Defines whether shoppers can pay with Boleto Bancario

N

ecp

Y/N

Defines whether shoppers can pay with Electronic Check/ACH

N

paysafecard

Y/N

Defines whether shoppers can pay with paysafe

N

realtimebank

Y/N

Defines whether shoppers can pay with real time banking. Applies only if this option is enabled for the merchant.

N

ccnumbervisible

Y/N

Indicates if the CC number field is visible (default: Y)

N

cctypevisible

Y/N

Indicates if the CC type field is visible (default: Y)

N

cctypedisable

Y/N

Indicates if the CC type field is disabled. Y - Disabled (default: N)

N

ccdatevisible

Y/N

Indicates if the CC expiration date field is visible (default: Y)

N

ccdatedisable

Y/N

Indicates if the CC expiration date field is disabled. Y - Disabled (default: N)

Y

expirationmonth

integer

CC expiration month

12

expirationyear

integer

CC expiration year

2019

ccstartdatevisible

Y/N

Indicates if the CC start date field is visible (default: Y, if start date is applicable for the selected CC type)

N

ccstartdatedisable

Y/N

Indicates if the CC start date field is disabled. Y - Disabled (default: N)

N

ccstartmonth

integer

CC start month

09

ccstartyear

integer

CC start year

2015

cccodevisible

Y/N

Indicates if the CC security code field is visible (default: Y, if start date is applicable for the selected CC type)

N

cccodedisable

Y/N

Indicates if the CC security code field is disabled. Y - Disabled (default:N)

Y

Billing information

You can use these parameters to pre-populate billing detail fields on the checkout page, and to customize which options appear.

Parameter
Type
Description
Example

billingfirstname

string

First name

John

billinglastname

string

Last name

Doe

billingfullName

string

Full billing name

JohnDoe

billingaddress1

string

Address line 1

1234 St. James Dr.

billingaddress2

string

Address line 2

Suite 123

billingcity

string

City

San Diego

billingstate

string

State

CA

billingzipcode

string

ZIP code or postal code

78467

billingcountry

two letter code according to ISO_3166-1

Country

us

billinginfocheckboxvisible

Y/N

Indicates if the billing info check box is visible. Y – visible (default: N)

Y

billinginfovisible

Y/N

Indicates if the billing info widget is visible. Y – visible (default: N - As default, it is shown only if the shopper checks the billing info checkbox)

Y

billinginfodisable

Y/N

Indicates if the billing info widget is disabled. Y - Disabled (default:N)

Y

billingfullnamevisible

Y/N

Indicates if the billing full name field is visible. Y – visible (default: Y)

Y

billingfullnamedisable

Y/N

Indicates if the billing full name field is disabled. Y - Disabled (default:N)

Y

billingfirstnamevisible

Y/N

Indicates if the billing first name field is visible. Y – visible (default: Y)

Y

billingfirstnamedisable

Y/N

Indicates if the billing first name field is disabled. Y - Disabled(default:N)

Y

billinglastnamevisible

Y/N

Indicates if the billing last name field is visible. Y – visible (default: Y)

Y

billinglastnamedisable

Y/N

Indicates if the billing last name field is disabled. Y - Disabled(default:N)

Y

billingaddress1visible

Y/N

Indicates if the billing address 1 field is visible. Y – visible (default: Y)

Y

billingaddress1disable

Y/N

Indicates if the billing address 1 field is disabled. Y - Disabled(default:N)

Y

billingaddress2visible

Y/N

Indicates if the billing address 2 field is visible. Y – visible (default: N)

Y

billingaddress2disable

Y/N

Indicates if the billing address 2 field is disabled. Y - Disabled(default:N)

Y

billingcityvisible

Y/N

Indicates if the billing city field is visible. Y – visible (default: Y)

Y

billingcitydisable

Y/N

Indicates if the billing city field is disabled. Y - Disabled (default:N)

Y

billingzipvisible

Y/N

Indicates if the billing zip code field is visible. Y – visible (default: Y)

Y

billingzipdisable

Y/N

Indicates if the billing zip code field is disabled. Y - Disabled (default:N)

Y

billingcountryvisible

Y/N

Indicates if the billing country field is visible. Y – visible (default: Y)

Y

billingcountrydisable

Y/N

Indicates if the billing country field is disabled. Y - Disabled (default:N)

Y

billingstatevisible

Y/N

Indicates if the billing state field is visible. Y – visible (default: Y, but only if relevant by the selected country)

Y

billingstatedisable

Y/N

Indicates if the billing state field is disabled. Y - Disabled (default:N)

Y

Shipping information

You can use these parameters to pre-populate shipping detail fields on the checkout page, and to customize which options appear.

Note

Shipping information fields are displayed on the checkout page when either:
(1) the 'Collect Shipping Address' option is enabled in the contract's settings (under General Settings > Miscellaneous); or
(2) the shopper opts to include a 'CD on Demand' in their order.

Parameter
Type
Description
Example

shippingfirstname

string

First name

John

shippinglastname

string

Last name

Doe

shippingfullName

string

Full name

JohnDoe

shippingaddress1

string

Address line 1

1234 St. James Dr.

shippingaddress2

string

Address line 2

Suite 123

shippingcity

string

City

San Diego

shippingstate

string

State

CA

shippingzipcode

string

ZIP code or postal code

78467

shippingcountry

two letter code according to ISO_3166-1

Country

US

shippinginfocheckboxvisible

Y/N

Indicates if the shipping info checkbox is visible. Y – visible (default: N)

Y

shippinginfovisible

Y/N

Indicates if the shipping info widget is visible. Y – visible (default: N - As default, it is shown only if the shopper checks the shipping info checkbox)

Y

shippinginfodisable

Y/N

Indicates if the shipping info widget is disabled. Y-Disabled (default:N)

Y

shippingfirstnamevisible

Y/N

Indicates if the shipping first name field is visible. Y – visible (default: Y)

Y

shippingfirstnamedisable

Y/N

Indicates if the shipping first name field is disabled. Y – Disabled (default: N)

Y

shippinglastnamevisible

Y/N

Indicates if the shipping last name field is visible. Y – visible (default: Y)

Y

shippinglastnamedisable

Y/N

Indicates if the shipping last name field is disabled. Y – Disabled (default: N)

Y

shippingfullnamevisible

Y/N

Indicates if the shipping full name field is visible. Y – visible (default: Y)

Y

shippingfullnamedisable

Y/N

Indicates if the shipping full name field is disabled. Y – Disabled (default: N)

Y

shippingaddress1visible

Y/N

Indicates if the shipping address 1 field is visible. Y – visible (default: Y)

Y

shippingaddress1disable

Y/N

Indicates if the shipping address 1 field is disabled. Y – Disabled (default: N)

Y

shippingaddress2visible

Y/N

Indicates if the shipping address 2 field is visible. Y – visible (default: N)

Y

shippingaddress2disable

Y/N

Indicates if the shipping address 2 field is disabled. Y – Disabled (default: N)

Y

shippingcityvisible

Y/N

Indicates if the shipping city field is visible. Y – visible (default: Y)

Y

shippingcitydisable

Y/N

Indicates if the shipping city field is disabled. Y – Disabled (default: N)

Y

shippingzipvisible

Y/N

Indicates if the shipping zip code field is visible. Y – visible (default: Y)

Y

shippingzipdisable

Y/N

Indicates if the shipping zip code field is disabled. Y – Disabled (default: N)

Y

shippingcountryvisible

Y/N

Indicates if the shipping country field is visible. Y – visible (default: Y)

Y

shippingcountrydisable

Y/N

Indicates if the shipping country field is disabled. Y – Disabled (default: N)

Y

shippingstatevisible

Y/N

Indicates if the shipping state field is visible. Y – visible (default: Y, but only if relevant for the selected country)

Y

shippingstatedisable

Y/N

Indicates if the shipping state field is disabled. Y – Disabled (default: N)

Y

Invoice information

You can use these parameters to pre-populate invoice detail fields on the checkout page, and to customize which options appear.

Parameter
Type
Description
Example

invoiceinfocheckboxvisible

Y/N

Indicates if the invoice checkbox is visible. Y – visible

Y

invoiceinfovisible

Y/N

Indicates if the invoice info is visible. Y – visible

Y

invoiceinfodisable

Y/N

Indicates if the invoice info is disabled. Y – disabled

Y

invoiceaddress1

string

Address line 1 on the invoice

1234 St. James Dr.

invoiceaddress1visible

Y/N

Indicates if the address 1 field is visible. Y – visible

Y

invoiceaddress1disable

Y/N

Indicates if the address 1 field is disabled. Y – disabled

Y

invoiceaddress2

string

Address line 2 on the invoice

Suite 100

invoiceaddress2visible

Y/N

Indicates if the address 1 field is visible. Y – visible

Y

invoiceaddress2disable

Y/N

Indicates if the address 1 field is disabled. Y – disabled

Y

invoicecity

string

City on the invoice

San Diego

invoicecityvisible

Y/N

Indicates if the city field is visible. Y – visible

Y

invoicecitydisable

Y/N

Indicates if the city field is disabled. Y – disabled

Y

invoicecompanyname

string

Company name on the invoice

Acme

invoicecompanynamevisible

Y/N

Indicates if the company name field is visible. Y – visible

Y

invoicecompanynamedisable

Y/N

Indicates if the company name field is disabled. Y – disabled

Y

invoicecountry

two letter code according to ISO_3166-1

Country on the invoice

US

invoicecountryvisible

Y/N

Indicates if the country field is visible. Y – visible

Y

invoicecountrydisable

Y/N

Indicates if the country field is disabled. Y – disabled

Y

invoiceemail

string

Email on the invoice

john@example.com

invoiceemailvisible

Y/N

Indicates if the email field is visible. Y – visible

Y

invoiceemaildisable

Y/N

Indicates if the email field is disabled. Y – disabled

Y

invoicefirstName

string

First name on the invoice

John

invoicefirstnamevisible

Y/N

Indicates if the first name field is visible. Y – visible

Y

invoicefirstnamedisable

Y/N

Indicates if the first name field is disabled. Y – disabled

Y

invoicefullName

string

Full name on the invoice

John Doe

invoicefullnamevisible

Y/N

Indicates if the full name field is visible. Y – visible

Y

invoicefullnamedisable

Y/N

Indicates if the full name field is disabled. Y – disabled

Y

invoicelastName

string

Last name on the invoice

Doe

invoicelastnamevisible

Y/N

Indicates if the last name field is visible. Y – visible

Y

invoicelastnamedisable

Y/N

Indicates if the last name field is disabled. Y – disabled

Y

invoicestate

string

State on the invoice

CA

invoicestatevisible

Y/N

Indicates if the state field is visible. Y – visible

Y

invoicestatedisable

Y/N

Indicates if the state field is disabled. Y – disabled

Y

invoicetitle

string

Title on the invoice

Mr

invoicetitlevisible

Y/N

Indicates if the title field is visible. Y – visible

Y

invoicetitledisable

Y/N

Indicates if the title field is disabled. Y – disabled

Y

invoiceworkphone

string

Work phone number on the invoice

800-123-4567

invoicephonevisible

Y/N

Indicates if the phone number field is visible. Y – visible

Y

invoicephonedisable

Y/N

Indicates if the phone number field is disabled. Y – disabled

Y

invoicezipcode

string

ZIP code on the invoice

01234

invoicezipvisible

Y/N

Indicates if the ZIP code field is visible. Y – visible

Y

invoicezipdisable

Y/N

Indicates if the ZIP code field is disabled. Y – disabled

Y

Shopper information

You can use these parameters to pre-populate shopper information fields on the checkout page, and to customize which options appear.

Parameter
Type
Description
Example

title

string

Title

Mr

companyname

string

Company name

Best Company

firstname

string

First name

John

lastname

string

Last name

Doe

fullname

string

Full name

JohnDoe

email

string

Email

shopper@shopper.com

address1

string

Address line 1

1234 St. James Dr.

address2

string

Address line 2

Suite 123

city

string

City

San Diego

state

string

State

CA

zip

string

ZIP code or postal code

78467

workphone

string

Work phone number

3456789123

faxnumber

string

Fax number

9876543333

brazilianId

string

Brazilian ID

390.533.447-05

shoppersprefvisible

Y/N

Indicates if the shopper language and currency preference fields are visible. Y – visible (default: Y)

N

shoppersprefdisable

Y/N

Indicates if the shopper language and currency preference fields are disabled. Y – disabled (default: N)

Y

shopperinfovisible

Y/N

Indicates if the shopper information fields are visible. Y – visible (default: Y)

N

shopperinfodisable

Y/N

Indicates if the shopper information fields are disabled. Y -Disabled (default:N)

Y

accountdetailsinfovisible

Y/N

Indicates if the shopper account details are visible. Y – visible

Y

companynamevisible

Y/N

Indicates if the company name field is visible. Y – visible (default: N)

Y

companynamerequire

Y/N

Indicates if the company name field is mandatory. (default:N)

Y

companynamedisable

Y/N

Indicates if the company name field is disabled. Y - Disabled (default:N)

Y

titlevisible

Y/N

Indicates if shopper's title field is visible. Y – visible (default: N)

Y

titlerequire

Y/N

Indicates if shopper title is mandatory. (default:N)

Y

titledisable

Y/N

Indicates if shopper title field is disabled. Y - Disabled (default:N)

Y

firstnamevisible

Y/N

Indicates if shopper first name field is visible. Y – visible (default: Y)

Y

firstnamedisable

Y/N

Indicates if the shopper first name field is disabled. Y - Disabled (default:N)

Y

lastnamevisible

Y/N

Indicates if shopper last name field is visible. Y – visible (default: Y)

Y

lastnamedisable

Y/N

Indicates if the shopper last name field is disabled. Y - Disabled (default:N)

Y

fullnamevisible

Y/N

Indicates if shopper full name field is visible. Y – visible (default: Y)

Y

fullnamedisable

Y/N

Indicates if the shopper full name field is disabled. Y - Disabled (default:N)

Y

emailvisible

Y/N

Indicates if the shopper email field is visible. Y – visible (default: Y)

Y

address1visible

Y/N

Indicates if the address line 1 field is visible. Y – visible (default: Y)

Y

address1disable

Y/N

Indicates if the address line 1 field is disabled. Y - Disabled (default:N)

Y

address2visible

Y/N

Indicates if the address line 2 field is visible. Y – visible (default: N)

Y

address2require

Y/N

Indicates if the address line 2 field is mandatory. (default:N)

Y

address2disable

Y/N

Indicates if the address line 2 field is disabled. Y - Disabled (default:N)

Y

cityvisible

Y/N

Indicates if the city field is visible. Y – visible (default: Y)

Y

citydisable

Y/N

Indicates if the city field is disabled. Y - Disabled

Y

zipvisible

Y/N

Indicates if the ZIP code field is visible. Y – visible (default: Y)

Y

zipdisable

Y/N

Indicates if the ZIP code field is disabled. Y - Disabled (default:N)

Y

countryvisible

Y/N

Indicates if the shopper’s country field is visible. Y – visible (default: Y)

Y

countrydisable

Y/N

Indicates if the shopper’s country field is disabled. Y - Disable (default:N)

Y

statevisible

Y/N

Indicates if the shopper’s state field is visible. Y – visible (default: Y, but only if relevant for the selected country)

Y

statedisable

Y/N

Indicates if the shopper’s state field is disabled. Y - Disabled (default: N)

Y

phonevisible

Y/N

Indicates if the shopper’s phone field is visible. Y – visible (default: Y)

Y

phonedisable

Y/N

Indicates if the shopper’s phone field is disabled. Y - Disabled (default: N)

Y

faxvisible

Y/N

Indicates if the shopper’s fax field is visible. Y – visible (default: N)

Y

faxrequire

Y/N

Indicates if fax field is mandatory. (default: N)

Y

faxdisable

Y/N

Indicates if the shopper’s fax field is disabled. Y - Disabled (default: N)

Y

Encrypted parameters

BlueSnap supports a number of parameters that should be encrypted before they are added to the URL. The list below describes these parameters. For instructions on using BlueSnap's API to encrypt the parameters, see Encrypt Parameters.

Parameter
Type
Description
Example

sku[contract ID]priceamount

string

Price for a contract

50

sku[contract ID]recurringpriceamount

string

Price for a recurring contract

100

sku[contract ID]pricecurrency

3 letter code according to ISO 4217 (case-insensitive)

Currency for a contract

EUR

sku[contract ID]recurringpricecurrency

3 letter code according to ISO 4217 (case-insensitive)

Currency for a recurring contract

EUR

sku[contract ID]trialdays

string

Number of trial days for a recurring ontract

30

thankyou.backtosellerurl

string

URL where the shopper will be directed after completing the purchase. The URL must be encoded, as shown in the example.

https%3A%2F%2Fmywebsite.com%2Fmypage
%3Finv%3D!%7Binvoice.id%7D<

shopperId

string

Used for Auto Login
ID of the shopper

19505364

expirationInMinutes

string

Used for Auto Login
Minutes until the checkout page expires

300

pageName

string

Used for Auto Login
Name of the page where the shopper will be directed

AUTO_LOGIN_PAGE

BuyNow Parameters