Contents x
    Products and Services
    • 22 Dec 2023
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Contents

    Products and Services

    • Updated on 22 Dec 2023
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Article summary

    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

    Numbers only

    Expected average transaction value

    averageTransactionValueExpected

    Numbers only

    Expected maximum transaction value

    maximumTransactionValue

    Numbers only

    Have you previously taken card payments?

    previousCardPayments

    Optional

    What is your anticipated charge back percentage?

    chargebackPercent

    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

    Was this article helpful?
    What's Next