Barclaycard HISO
There are two options for boarding a Barclaycard HISO merchant: boarding via the Gateway Manager and via the API.
Boarding via the Gateway Manager
To board a Barclaycard HISO merchant in the Gateway Manager, you will need the following data:
- Barclaycard Merchant ID
- Sort Code of settlement account
- Merchant Name
- Merchant City
- Once you have the above data, open the merchant in the Gateway Manager and select Attach processing path.
- Select Barclaycard HISO as Clearing Institute and enter the data.
- To finish setup, select Attach processing path.
Boarding via the API
1. Create a Merchant with a Barclaycard processing path.
{ "processingPaths": [ { "currencies": [ "GBP" ], "schemes": [ "VISA", "VISAELECTRON", "V_PAY", "MASTER", "MAESTRO" ], "details": { "institute": "BARCLAYCARD_HISO", "country": "GB", "sortCode": "123456", "merchantId": "123456", "merchantAcceptorName": "Barclaycard Merchant", "merchantAcceptorCity": "London" }, "name": "Default processing", "active": true } ], "name": "Test Merchant", "readers": [ ], "details": { "publicName": "Barclaycard Sample", "address": "Street 1", "zip": "12345", "city": "London", "country": "GB", "contact": "123456", "additionalInformation": "VAT Number: 123456" } }
Pay special attention to those parameters:
- $.name
- Specify a unique (internal) name for each merchant that you create.
- $.details
- For the payment receipts, you need to provide some information about the merchant, includingPublic Name, Address and a Contact Phone Number/Email Address.
You will receive a
merchantIdentifier
after successfully creating the merchant:Response
{ "status": "ok", "data": { /*...*/"identifier": "74b47dcd-45b0-4c65-a4d1-afd4aae32708", "name": "Test Merchant" /*...*/ } }
2. Generate the Merchant Secret Key for the Merchant via the API:
{ "permissions": ["READER_MANAGEMENT","TRANSACTIONS"] }
You will receive the Merchant Secret Key in the response:
Response
{ "status": "ok", "data": { "status": "ACTIVE","key": "9pCcTI2mzUbLKoCdezVBowhv0b6gGwoo"} }
3. (Optional) Find the card reader you want to assign to the merchant.
The platform keeps track of all the card readers that you purchased. In order to assign a reader to the new merchant you have created in Step 1 above, you must know the card reader's
readerIdentifier
. Use this API to find the readerIdentifier
of a reader based on its serial number (e.g., 999-100001):You will receive the
readerIdentifier
in the response:Response
{ "status": "ok", "data": [{ /*...*/"identifier": "0665ede3-3990-4c9b-beac-77abfeda5858", "model": "MIURA_M010", "details": { "serialNo": "999100001" /*...*/ } }] }
4. (Optional) Assign the card reader to new merchant.
Based on the
merchantIdentifier
from Step 1 and the readerIdentifier
from Step 3, you can now assign the reader to the merchant:Request