• Host2Host
• Full Page
• Payform JS SDK

• One-Step Payment
• Two-Step Payment
• Full Refund
• Partial Refund
• Reversal
• Recurring

• Payment Method Saving
• Use of Travel Data
• Use of Account Funding details
• Automatic Billing Updater

South Africa, Australia, China (mainland), Hong Kong, Japan, Macao, New Zealand, Singapore, Taiwan, Armenia, Austria, Azerbaijan, Belarus, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Faroe Islands, Finland, France, Georgia, Germany, Greece, Greenland, Guernsey, Hungary, Iceland, Ireland, Isle of Man, Italy, Kazakhstan, Jersey, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Monaco, Montenegro, Netherlands, Norway, Poland, Portugal, Romania, Russian Federation, San Marino, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Ukraine, United Kingdom, Vatican, Argentina, Colombia, Costa Rica, Brazil, Mexico, Peru, Bahrain, Israel, Palestine, Qatar, Saudi Arabia, United Arab Emirates, Canada, United States.

USD, GBP, EUR, RUB, AUD, SEK, CAD, CHF, DKK, JPY, PLN, CZK, NOK, AED, BYN, CNY, KZT, NZD, UAH, AZN, GEL, KGS, UZS, ZAR, AMD, ARS, BGN, BRL, CLP, EGP, HKD, HRK, HUF, IDR, ILS, INR, ISK, KES, KRW, LKR, MAD, MDL, MKD, MOP, MUR, MXN, MYR, NGN, PEN, PHP, QAR, RON, RSD, SAR, SGD, THB, TJS, TMT, TRY, TWD, UYU, VND, ZWL.

Transaction limits differ for each currency and market. If you want to find out more about a particular market or currency, contact your Cardaq account manager.

Full Page

1. Go to your Cardaq Gate account;
2. Navigate to Settings, then select the Payment Methods section, and click the "Configure" button for Apple Pay;
3. Select the option “Use the Gateway’s Apple Developer certificate”;
4. Click the "Enable" button from the action column;
5. Verify that the status has changed to Enabled. Once confirmed, you will be authorized to process Apple Pay transactions.

Payform JS SDK

1. Go to your Cardaq Gate account, select Settings, then the Payment Methods section and click the "Configure" button for Apple Pay;
2. Choose “Use the Gateway’s Apple Developer certificate“;
3. Click to “Add a domain“ button;
4. Enter your domain;
5. Download the domain verification file;
6. Add the downloaded file to your domain to the path: /.well-known/apple-developer-merchantid-domain-association;
7. Click the "Enable" button from the action column;
8. Make sure that the status is changed to Enabled. If it is, you are now able to perform Apple Pay transactions.

Host2Host

1. Log in to your Apple Developer account and follow the instructions to create a merchant identifier and merchant identity certificate (assigned to the identifier);
2. Go to your Cardaq Gate account, select Settings, then the Payment Methods section and click on the "Configure" button for Apple Pay;
3. Click on the “Add new certificate", select the appropriate website, enter the domain name, and then click "Add";
4. After adding a new certificate, it will appear in the Apple Pay Certificates section with status pending. In order to activate it, click on the Actions menu and choose to upload a certificate. A new view will be presented where you download the CSR file. Then, go to your Apple Developer account and follow these instructions to create a payment processing certificate.
   NB: Make sure you use the same merchant identifier as in the previous steps. When you are asked to upload a Certificate Signing Request, select the CSR you just downloaded from the Merchant Portal. Then, download and save the generated payment processing certificate as a .cer file. Now you can upload the certificate you received from Apple in the Merchant Portal. Once that is done, click “Add”;
5. You will now see the certificate attached to your application. The status - pending or active - indicates whether the certificate is active. If it is, you are now able to perform Apple Pay transactions with Cardaq;

6. This step is required only if you are integrating Apple Pay with your app. Ignore this step, if you intend to integrate Apple Pay with your website only.
   In order to enable Apple Pay for an app, log in to your Apple Developer account and follow these instructions.

Common Order Request Example

Once you have successfully enabled Apple Pay for your account, you can start to initiate payments. You as a merchant create the initial order. Example:

{
  "client": {
    "email": "adam.smith@company.com"
  },
  "products": [
    {
      "price": 0.30,
      "title": "My Product"
    }
  ]
}

Full Page

If you are using the Cardaq hosted payment page, no technical changes are required from your side. After you redirect your customer to the appropriate URL and their device is compatible, they will be able to choose whether to pay by card or by Apple Pay. All communication with Apple Pay during the payment process is handled by Cardaq.

Payform JS SDK

If you are using the Cardaq Payform JS SDK, no technical changes are required from your side. Customers will be able to choose on the payform whether to pay by card or by Apple Pay. All communication with Apple Pay during the payment process is handled by Cardaq.

• Host2Host
• Full Page
• Payform JS SDK

• One-Step Payment
• Two-Step Payment
• Full Refund
• Partial Refund
• Reversal
• Recurring

• Payment Method Saving
• Use of Travel Data
• Use of Account Funding details
• Automatic Billing Updater

Afghanistan, Albania, Algeria, Andorra, Angola, Antigua and Barbuda, Argentina, Armenia, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bhutan, Bolivia, Bosnia and Herzegovina, Botswana, Brazil, Brunei, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Central African Republic, Chad, Chile, Colombia, Comoros, Costa Rica, Côte d'Ivoire, Croatia, Cyprus, Czech Republic, Democratic Republic of the Congo, Denmark, Djibouti, Dominica, Dominican Republic, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Eswatini, Ethiopia, Fiji, Finland, France, Gabon, Gambia, Georgia, Germany, Ghana, Greece, Grenada, Guatemala, Guinea, Guinea-Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Mauritania, Mauritius, Mexico, Micronesia, Moldova, Monaco, Mongolia, Montenegro, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands, New Zealand, Nicaragua, Niger, Nigeria, North Macedonia, Norway, Oman, Pakistan, Palau, Palestine, Panama, Papua New Guinea, Paraguay, Peru, Poland, Portugal, Qatar, Republic of the Congo, Romania, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Vincent and the Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Sierra Leone, Serbia, Seychelles, Singapore, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, South Sudan, Spain, Sri Lanka, Sudan, Suriname, Sweden, Switzerland, Taiwan, Tajikistan, Tanzania, Thailand, Timor-Leste, Togo, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom and outlying territories, United States and outlying territories, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Yemen, Zambia, Zimbabwe

USD, GBP, EUR, RUB, AUD, SEK, CAD, CHF, DKK, JPY, PLN, CZK, NOK, AED, BYN, CNY, KZT, NZD, UAH, AZN, GEL, KGS, UZS, ZAR, AMD, ARS, BGN, BRL, CLP, EGP, HKD, HRK, HUF, IDR, ILS, INR, ISK, KES, KRW, LKR, MAD, MDL, MKD, MOP, MUR, MXN, MYR, NGN, PEN, PHP, QAR, RON, RSD, SAR, SGD, THB, TJS, TMT, TRY, TWD, UYU, VND, ZWL

Transaction limits differ for each currency and market. If you want to find out more about a particular market or currency, contact your Cardaq account manager.

Contact your Cardaq account manager to enable this payment method.

Common Order Request Example

Once you have successfully enabled Google Pay for your account, you can start to initiate payments. You as a merchant create the initial order. Example:

{
  "client": {
    "email": "adam.smith@company.com"
  },
  "products": [
    {
      "price": 0.30,
      "title": "My Product"
    }
  ]
}

Full Page

If you are using the Cardaq hosted payment page, no technical changes are required from your side. After you redirect your customer to the appropriate URL and their device is compatible, they will be able to select whether to pay by card or by Google Pay. All communication with Google Pay during the payment process is going to be handled by Cardaq.

Payform JS SDK

If you are using the Cardaq Payform JS SDK, no technical changes are required from your side. Customers will be able to select on the payform whether to pay by card or by Google Pay. All communication with Google Pay during the payment process is going to be handled by Cardaq.

• Host2Host
• Full Page
• Payform JS SDK

• One-Step Payment
• Two-Step Payment
• Full Refund
• Partial Refund
• Reversal

• Use of Travel Data
• Use of Dynamic Descriptor
• Use of Service Location details
• Address Verification System

United Kingdom

GBP

Contact your Cardaq account manager to enable this payment method.

Common Order Request Example

Once you have successfully enabled Visa Instalments for your account, you can start to accept Visa Instalment payments. You as a merchant create the initial order. Example:

{
  //required
  "client":{
    "email": "adam.smith@company.com"
  },
  "products": [
    {
      "quantity": "1",
      "price": "50",
      "title": "My Product"
    }
  ],
}

Full Page

If you are using the Cardaq hosted payment page, no technical changes are required from your side. After you redirect your customer to the appropriate URL, they will see if their card is eligable for instalments. If it is, then the customer can select either to pay all amount in full or choose a plan and pay in instalments. Payment processing is the same as for regular orders.

Payform JS SDK

If you are using the Cardaq Payform JS SDK, no technical changes are required from your side. Once you customer has submitted their card data, they will see if their card is eligable for instalments. If it is, then the customer can select either to pay all amount in full or choose a plan and pay in instalments. Payment processing is the same as for regular orders.

Host2Host

1. Check if the card is eligible for Visa Instalments and request Instalment plans by sending Visa card number in the request to Cardaq Gate instalment_plans endpoint.

Request example:

{
  "card_number": "411111******1111"
}

Response example if the plans are available:

{
  "instalment_request_id": 12,
  "instalment_plans": [
    {
      "id": "string",
      "frequency": "string",
      "number_of_instalments": 3,
      "terms_conditions": [
        {
          "url": "string",
          "version": 4,
          "text": "string",
          "language": "string"
        }
      ],
      "annual_percentage_rate": 3.0,
      "total_amount": 353.5,
      "total_fee": 3.51,
      "amount": 117.83,
      "fee": 1.17
    }
  ]
}

Response example if the plans are not avaible:

{
  "instalment_request_id": "12345",
  "instalment_plans": []
}

2. If the plans are available and the cardholder has selected the desired plan, certain fields from the instalment_plans response should be sent in api_do_url request.

Request example:

{
  "cardholder_name": "GATETEST123",
  "card_number": "411111******1111",
  "exp_month": "05",
  "exp_year": "24",
  "csc": "***",
  "instalment_plan":{
    "instalment_request_id": 123, //taken from /instalment_plans response - mandatory for Instalment plans
    "id": "...", //taken from /instalment_plans response - mandatory for Instalment plans
    "version": 4, //taken from /instalment_plans response - mandatory for Instalment plans
    "language": "eng" //taken from /instalment_plans response - mandatory for Instalment plans
  }
}

3. As a response you will receive either a payment status or a link to the 3DS check.