21 minutes to read

🛈 Important

This topic applies only when processing payments using CardConnect

These are the specific to the Payment service account tab.  The items in bold are the fields relevant to Payment services.  You will need to obtain merchant specific settings from the payment provider in order to complete these settings.


Field

Description

Required

Auto set

Sample value

Card mapping

See the article on Card mapping field.

Yes

Yes

Default:VISA;VISA:VISA;MASTERCARD:MASTER;DISCOVER:DISCOVER;
AMEX:AMEXPRESS;DINERCLUB:VISA;JCB:VISA;CARTEBLANCHE:VISA;
GiftCard:GiftCard;Debit:Debit;MAESTRO:MAESTRO;

Merchant id

Enter the Merchant ID (MID).  This is provided by CardConnect.

Yes

No

Test@1234

Username

Enter the username provided by CardConnect.

Yes

No

Testuser

Password

Enter the password provided by CardConnect.

Yes

No

Test@pwd

Device serial number (HSN) (Obsolete)

This field should be left blank.

Yes

No


Auth key

When using a Payment device to create a customer credit card, set this field to the Auth Key:

Test/UAT:

ZCb8pPkXcZDVO0CIngLSFrBJgA/BYyUZIHT8zaj3MPg=

Live/Production:

l0AY/ldGk/FnY2d51VWNDQXQiOk3AqioBYeNuWnt16A=

When using an iFrame tokenizer to create a credit card, leave this field blank.

Yes

No

See values

Line display (Obsolete)

This field is not used. Leave as the default value (0)

No

No

0

Enable customer account signature (Obsolete)

This field is not used. Leave as the default value (0)

No

No

0

Pinpad signature support (obsolete)

This field is not used. Leave as the default value (0)

No

No

0

Device type

This field is not used. Leave as the default value (0)

No

No

0

Pinpad support debit (obsolete)

This field is not used. Leave as the default value (0)

No

No

0

Bypass pin debit (obsolete)

This field is not used. Leave as the default value (0)

No

No

0

Bolt URL

Enter the correct URL:
Test/UAT:

https://bolt-uat.cardpointe.com/

Live/Production:

https://bolt.cardpointe.com/

Yes

No

https://...

Gateway base api URL

Enter the Gateway base api URL.

Test/UAT:

https://boltgw-uat.cardconnect.com/

Live/Production:

https://boltgw.cardconnect.com/

Yes

No

https://...

Device mode

1:  Use a Payment terminal to create Customer tokens at Headquarters.

0: Use the CardConnect iFrame tokenizer to create Customer tokens at headquarters.

No

No

0

Total amt shown on Account Signature





Show billing address code

Control which Billing address fields are shown on the iFrame tokenizer (see below).

No

No

0

Required billing address code

Control which Billing address fields are mandatory on the iFrame tokenizer (see below).

No

No

0

Avs check

See additional documentation




Avs check level





Advance order flow

Use this flag to control how Capture operates when partially Invoicing.  See additional documentation

No

No

0

Payment accept web URL

Enter the URL for the Payment accepting page (see below).

No

No

https://...


Address verification




Address Verification

This standard Microsoft setting is not supported.  Leave this option disabled.  AVS support is configured above

No

No



Card verification value




Card Verification Value

Enable this option to Prompt CVV option while authorizing sales order

No

No


Allow blank card verification value

Enable CVV to allow blank CVV while authorizing sales order.

No

No



iFrame Tokenizer Billing address field control

The profile fields Show billing address code and Required billing address code gives you control over the Billing address fields on the CardConnect iFrame tokenizer form.

Show billing address code

This field accepts a single or combination of codes to control which fields are displayed.


Code

Address field 

1

All fields

2

Cardholder name

3

Street address

4

City

5

State

6

Zip/Postal code

7

Country

8

Phone number


Setting this field to 1 will display all Billing address fields on the iFrame tokenizer form.

Setting the field to 0 will not display any Billing address fields.

Combination of fields

This field accepts a single or combination of codes to control which field(s) are mandatory.

To display a combination of fields, concatenating the field codes, for instance, a field value of 2346 would display:

  • Cardholder name
  • Street address
  • City and
  • Zip/Postal code

Required billing address code

The parameter Required billing address code controls which fields are mandatory.


Code

Address field 

1

All fields

2

Cardholder name

3

Street address

4

City

5

State

6

Zip/Postal code

7

Country

8

Phone number


For example, setting the field to 26 would force these fields to become mandatory:

  • Cardholder name
  • Zip/Postal code


Note: To use the billing address functionality on the iframe, set the Payment accept web URL field in the payment service must use the default value http://localhost:3973

Setting the Payment accept web URL

The Payment accept web URL points to the CardPage.html file which manages the CardConnect iFrame tokenizer.To set this field, you must concatenate your AOS URL with the CardPage URL: 

/Connectors/CardConnectConnector/CardPage.html

e.g.  If your AOS URL is https://u10testvm01f7ef13ab5799568faos.cloudax.dynamics.com/

Then set this field to: https://u10testvm01f7ef13ab5799568faos.cloudax.dynamics.com/Connectors/CardConnectConnector/CardPage.html


Card mapping field