Barclaycard

Obtaining a test account

1. 1

   Sign up for a test account with Barclaycard via their website.

2. 2

   After logging in with your new account, and setting a new password if required, you'll land on the dashboard with a list of Activation steps.

3. 3

   Select Your payment methods from the Activation steps, then Choose new payment methods.

4. 4

   Click Add on the Visa payment method.

5. 5

   On the add screen, leave the first two options — Do you have a contract? and Select an acquirer — as they are by default. In the Acquirer specific data section, enter 1234567 in the Affiliation number input.

6. 6

   Press Submit.

7. 7

   Once the payment type has been added, select PM activation in the green navigation bar.

8. 8

   Change the radio button to Yes and select Submit.

9. 9

   If you'd like, add other card payment methods such as Mastercard so you can test with other card types.

10. 10

    Click Home to return to the Activation steps, then select Your technical settings.

11. 11

    To get the account activated, configure the SHA-IN pass phrase in the Data and origin verification tab, in the first group titled Checks for e-Commerce & Alias Gateway. This pass phrase must be alphanumeric and at least 16 characters long. It can be changed later if needed.

12. 12

    Leave the options in the group titled Checks for Barclaycard Direct Link blank.

13. 13

    Once you've added a SHA-IN pass phrase, select Save.

14. 14

    On the Global transaction parameters tab, set Processing for individual transactions to Always online (Immediate) and press Save.

15. 15

    Return to Home and click the new Activate your account option at the bottom of the Activation steps to activate your account.

Creating API users

Once your Barclaycard test account is configured and activated, create a user for Foxy to use when connecting to Barclaycard for payments.

1. 1

   In the Barclaycard administration, go to Configuration > Users. If you don't see this option yet, make sure your account is activated, then log out and back in.

2. 2

   Select New User from the Users section.

3. 3

   Enter a UserID, User's name, Email address and Timezone.

4. 4

   For Profile, select Admin.

5. 5

   Check Special user for API (no access to admin.).

6. 6

   Enter your admin account password in the final field and click Create.

7. 7

   On the following screen you'll set a password for this user. Enter your own account's password in the first field, then the new password for the API user in the next two fields. Make a note of this password — you'll need it for the Foxy administration in the next section.

Connecting Barclaycard to Foxy

1. 1

   Log in to your store's Foxy administration and go to the payment settings.

2. 2

   Make sure the Payment Servers option is set to Test Servers.

3. 3

   In the Let customers pay with a Credit or Debit Card section, select Barclaycard from the bank card payment method option.

4. 4

   In the test pspid field, enter your Barclaycard account's PSPID value. You can find it referenced in the footer of the Barclaycard administration, and it's what you specified when signing up for the test account.

5. 5

   In the test user field, enter the UserID you specified when creating the API user.

6. 6

   In the test password field, enter the password you set for the API user.

7. 7

   Save the payment settings.

You'll also need to make sure your store is configured to use GBP, since that's the currency used for the test account. Go to the template sets section in the administration and select a locale that uses GBP, such as English locale for Britain.

Testing

By default, Barclaycard provides transaction responses based on the total amount of the order. If the order total is between £0 and £9000 the transaction succeeds; between £9001 and £9999 it's declined. Any card numbers can be used, as long as you enabled support for them in your payment methods configuration earlier.

Some example test card numbers:

• Visa 4111 1111 1111 1111

• Mastercard 5399 9999 9999 9999

• American Express 3741 1111 1111 111

You can also switch the test results to be based on the card number used. In the Barclaycard administration, go to Configuration > Technical information > Test info to change that and see more details.

Switching your Barclaycard account to production

Once you've completed testing, switch your Barclaycard account into production mode so you can start taking live payments. You'll need to reach out to the Barclaycard support team to discuss your account and confirm any configurations that need to be made.

Once your account is switched to production, switch your Foxy payment settings to live servers. If you haven't yet started your Foxy store subscription, you'll need to do that first.

After switching to live, enter your production Barclaycard credentials and save the payment settings.

Special consideration: prepayment webhook

If you have 3-D Secure enabled for your Barclaycard account and Foxy store, a slightly different trigger occurs for the prepayment webhook if it's enabled for your store. It will have a Foxy-Webhook-Event header of validation/3ds instead of validation/payment.

Barclaycard approach capturing payments with 3DS differently to other gateways: they capture the payment as soon as the 3DS process completes, rather than responding that the customer was validated and letting us capture as a separate request.

This means that if you're using the prepayment webhook to prevent transactions from completing, and you're matching against the event header, you'll need to allow for both validation/3ds and validation/payment.

Troubleshooting & interpreting response codes

"The data you entered is not correct. Please retry"

If you get a gateway error of "There was an error processing your payment: The data you entered is not correct. Please retry.", this generally points to your gateway credentials being incorrect. Double check that the PSPID, User and Password fields are correct for the respective data in your accounts.