Products and Services

The website URL is populated from the Create Merchant request. The rest of the fields are populated from an Update Product request

Products and services show different fields for different delivery time range options depending on whether they are digital/physical/etc. The goodsDeliveryEstimatedTime field time ranges are represented in the API calls with the numbers 0, 1, 2, 3, 4+.

 

 

How to get an ETag

In order to submit an Update Products call you will need the ETag number of the product details. This is used in the If-Match header parameter of the Update Products PUT request, to make sure that you are updating the latest version of the products object. If the If-Match number doesn’t match the ETag number the request will fail.

To do this you will need Get Products API call to get the product details for the merchant (you should normally see one result being returned).

The ETag is returned in the response header. For more information on ETags, see the Optimistic Locking topic

 

The following table presents the minimal data and the field names in the call.

Portal Field	API attributes productDetails/ +	Values
I sell Physical Goods	physicalGoods	If ticked then true, else false
Are the goods sold dispatched from your warehouse?	warehouseDispatched	If YES selected then true If NO selected then false.
From the date of payment when does the customer receive the goods?	goodsDeliveryEstimatedTime	if Same day then “0” if Within one week then ”1” if Within two weeks then “2” if Within three weeks then “3” if Four weeks or more then”4+”
Please provide details of the products and services you offer	description	Max 1000 chars
I sell services to customers	services	If ticked then true, else false
Are services provided paid in advance or in arrears?	servicesPaymentType	Possible values are: [IN_ADVANCE, IN_ARREARS]
From the date of payment when are the services provided?	servicesDeliveryEstimatedTime	if Same day then “0” if Within one week then”1” if Within two weeks then “2” if Within three weeks then “3” if Four weeks or more then”4+”
I sell digital services	digitalServices	If ticked then true, else false
Are these services available immediately?	digitalServicesImmediateAvailability	If ticked then true, else false
How long are these digital services valid for?	digitalServicesValidityTime	if Day of purchase only then “0” if Up to one week then”1” if Up to two weeks then “2” if Up to three weeks then “3” if Four weeks or more then”4+”
When will the digital services be made available from time of payment?	digitalServicesAvailabilityTime	if Same day then “0” if Within one week then”1” if Within two weeks then “2” if Within three weeks then “3” if Four weeks or more then”4+”
Expected monthly  turnover	mothlyTurnoverExpected	if <£1000 then"1000" if £1001 - £5000 then "5000" if £5001 - £10000 then "10000" if £10001 - £50000 then "50000" if >£50001 then "50001"
Expected average transaction value	averageTransactionValueExpected	if <£100 then "100" if £101 - £250 then "250" if £251 - £500 then "500" if £501 - £1000 then "1000" if >£1001 then "1001"
Expected maximum transaction value	maximumTransactionValue	if <£100 then "100" if £101 - £250 then "250" if £251 - £500 then "500" if £501 - £1000 then "1000" if >£1001 then "1001"
Have you previously taken card payments?	previousCardPayments	optional
Do not use MOTO	MOTO currently not supported	Unsupported

The merchant Website API endpoint is merchants/organizationDetails/tradingWebsite and this is supplied during "Create Merchant" call. It has a maximum length of 100 characters and there is no authentication

Next Step: Contact.