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
  1. Once you have the above data, open the merchant in the Gateway Manager and select Attach processing path.
  2. Select Barclaycard HISO as Clearing Institute and enter the data.
  3. To finish setup, select Attach processing path.
Boarding via the API
1. Create a Merchant with a Barclaycard processing path.
post
/v2/merchants/
Try it out!
Request
{ "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, including
Public 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:
post
/v2/merchants/{merchantIdentifier}/secretKey
Try it out!
Request
{ "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):
get
/v2/readers/?search=999-100001
Try it out!
Request
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:
put
/v2/merchants/{merchantIdentifier}/readers/{readerIdentifier}
Request