Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Windcave

This feature is a Private Beta Release. Contact support to enable Windcave via payFURL for your Test and Live site.

Introduction

Windcave is a well-known payment gateway and online payment processing provider. It offers a range of payment solutions to businesses globally. As a payment gateway, Windcave facilitates secure electronic transactions, enabling businesses to accept payments online in different channels.

Chargebee is integrating Windcave via payFURL. payFURL is a payment orchestration platform that provides payment-related API services and specializes in payment gateway integrations.

Information

Since this integration is supported through a partner (payFURL), using Metrics Global via payFURL will incur an additional charge. Contact your Chargebee Account Manager or Chargebee Support for more information.

Choosing Windcave

Consider the following factors before choosing Windcave as a payment solution:

  • Countries: Windcave is currently available for companies based in Australia and New Zealand.
  • Payment Methods: Windcave supports almost all major credit and debit cards such as Visa, MasterCard, American Express, Diners Club, and so on.
  • Currencies: Here's a list of the primary currencies supported by Windcave:
Currency Abbreviation and Full Name
AED - United Arab Emirates DirhamARS - Argentine PesoAUD - Australian DollarBDT - Bangladeshi TakaBND - Brunei DollarCAD - Canadian Dollar
PLN - Polish ZlotyCNY - Chinese YuanHRK - Croatian KunaCZK - Czech Republic KorunaDKK - Danish KroneFJD - Fijian Dollar
GBP - British Pound SterlingHKD - Hong Kong DollarHUF - Hungarian ForintIDR - Indonesian RupiahILS - Israeli New ShekelINR - Indian Rupee
BRL - Brazilian RealKRW - South Korean WonJPY - Japanese Yen (Zero Decimal)MOP - Macanese PatacaMYR - Malaysian RinggitMUR - Mauritian Rupee
MXN - Mexican PesoNZD - New Zealand DollarNOK - Norwegian KronePGK - Papua New Guinean KinaPHP - Philippine PesoQAR - Qatari Rial
RUB - Russian RubleSAR - Saudi RiyalSGD - Singapore DollarZAR - South African RandSEK - Swedish KronaCHF - Swiss Franc
THB - Thai BahtTOP - Tongan Pa'angaUSD - United States DollarTWD - New Taiwan DollarRON - Romanian LeuTRY - Turkish Lira
BGN - Bulgarian LevEUR - EuroCLP - Chilian Peso (Zero Decimal)

Integration Options

You can integrate Windcave using the following:

Integration MethodDescriptionPCI Requirements
Chargebee Hosted PagesIn this method, customers' card information is collected by Chargebee's checkout and directly passed on to Windcave.Low (Your PCI compliance requirements are greatly reduced due to usage of Chargebee's checkout.)
Chargebee JSIn this method, you can use Chargebee Components and Hosted Fields to collect the customer's card details.Low
Chargebee JSUsing Permanent Token - a token that represents a customer's card details stored in Windcave's vault to process payments.

When creating a new token and converting card details to tokens using:
Hosted Components: Low
Your own Checkout: High

Chargebee JSVia Raw Card details
You will collect raw card details via your custom checkout and pass it to Chargebee.js.
High
Chargebee APIIn this method, you will have to collect card information and pass it on to Chargebee via API. Chargebee then routes this card information to Windcave.
Since you will be collecting card information directly, you will have to take care of PCI Compliance requirements.
High

Note

3D-Secure is not supported for this integration.

Retrieving Credentials from your Windcave Account

You are required to enter the Username and API Key while adding Windcave to your Chargebee site.

  1. Reach out to the Windcave account manager/ Windcave Support to create your developer account in Windcave.
  2. You will receive an email from Windcave with your REST API credentials. Keep the REST API Username and REST API Key safe for entering them in your Chargebee site.

Configuring Windcave in your Chargebee Site

Follow the steps below to configure Windcave in your Chargebee site:

  1. Login to the Chargebee app.
  2. Click Settings > Configure Chargebee > Payment Gateways.
  3. Click Add Gateway and select Windcave.
  4. Enter your Rest API Username in the Username field and the Rest API Key in the API Key field as retrieved in the previous section.
  5. Click Connect.

Configuring Card Settings

  1. On the Configure Windcave page, click Manage for Cards.
  2. Card Verification: If this option is enabled, $1 is deducted from the customer's card for validation. This amount is refunded immediately. Note that cards that do not pass this validation will not be added.
  3. Always retain card information in Windcave when customer updates it: Enabling this option stores the updated card information in Windcave rather than the default gateway.
  4. Click Save.
  5. Click Apply.

Note

  • You do not need to configure webhook endpoints for Windcave. Chargebee handles all responses synchronously during transaction processing. To enable the integration, simply configure the Windcave gateway in your Chargebee site.
  • This integration supports the use of the Payment Initiator API parameter which when passed along with the transaction, helps Chargebee distinguish between Customer and Merchant-Initiated transactions and handle the payment more effectively. Learn more

Limitations

  1. Windcave operates in Australia and New Zealand in the following states only. If your customer adds a new card from any other country or state, Windcave will not accept it.

    • New South Wales
    • Victoria
    • Queensland
    • Western Australia
    • South Australia
    • Tasmania
    • Northern Territory
    • Australian Capital Territory
    • Norfolk Island
    • Jervis Bay
    • Lord Howe Island
    • Christmas Island
    • Cocos (Keeling) Islands
    • Macquarie Island
    • New South Wales
    • Melbourne
    • Wollongong
    • Canberra
    • Other Territories
    • Sydney
  2. When using Chargebee public APIs, the merchant should pass state_code with the billing_address as Windcave accepts values as state_code only.

    This feature is currently not supported in Chargebee-hosted pages, as a new enhancement is to be made w.r.t address. Reach out to Chargebee support if you want to use this in Chargebee-hosted pages.

Was this article helpful?