Skip to main content

PointOfSaleListResponse

pageinteger

The current pagination page

perPageinteger

The requested number of entries per page

lastPageinteger

The last page with entries

totalinteger

The total number of entries

firstPageUrlstring

URL for the first page

lastPageUrlstring

URL for the last page

nextPageUrlstringnullable

URL for the next page

previousPageUrlstringnullable

URL for the previous page

nextPageintegernullable

The page number for the next page. Null if no next page.

previousPageintegernullable

The page number for the previous page. Null if no previous page.

frominteger

The entry offset for the first entry in the page

tointeger

The entry offset for the last entry in the page

pathstring

The path for the pagination endpoint

items object[]

The page contents

  • Array [
  • pointOfSale object
    iduuidrequired

    The ID of the point of sale. This is used when creating new payment session.

    namestringrequired

    A visual name displayed in the ePay backoffice to help the merchant and ePay staff identify the point of sale

    descriptorstringrequired

    The merchant name displayed to the cardholder in both their bank statement and any 3DS challenge such as MitID.

    createdAtdate-timerequired

    The time of creation in UTC.

    updatedAtdate-timerequired

    The last time the point of sale was modified in UTC

    hostedConfiguration object

    The hosted configuration acts as the default values for most of the session initialization parameters. If fields such as maxAttempts is not defined within the /cit call, the value will be fetched from the hosted configuration instead.

    instantCapturestringrequired

    If the payment should be captured instantly or not.

    • OFF indicates that the payment should not be captured instantly.
    • VOID indicates that the payment should be captured instantly and if somehow the instant capture fails the payment is voided.
    • NO_VOID indicates that the payment should be captured instantly and if the capture fails the authorization is kept (no void is made)

    scaModestringrequired

    How 3D secure is handled:

    • SKIP 3DS is not tried and full liability is put at merchant.
    • NORMAL 3DS flow is attempted as normal guidelines suggests - Both challenge and frictionless can occur.
    • FORCE A challenge flow is forced. Note: Third parties in the 3DS flow might ignore this instruction.

    Possible values: [SKIP, NORMAL, FORCE]

    timeoutintegerrequired

    How many minutes sessions stays active.

    notificationUrlurirequired

    The URL to receive webhook notifications for any attempted transactions

    successUrlurirequired

    The URL the client is redirected to on successful payments

    failureUrlurirequired

    The URL the client is redirected to when no more payment attempts is possible for the current session.

    retryUrlurinullable

    The URL the client is redirected to on failed payments while there is still more attempts available. If null, then failureUrl is used as a fallback.

    maxAttemptsintegerrequired

    The maximum number of transaction attempts allowed for the payment session

    processorProcessor (string)[]required

    List of processors to use. This is the routing of the payment. The value can be shift4, clearhaus and nets.

    The priority of the processors is made on the order. That means that if the first processor fails / declines then the next in the list will be used and so on until all processors in the list have been tried. The order is not guaranteed as it depends on external factors such as the specific payment card used by the cardholder.

    Possible values: [shift4, clearhaus, nets, worldline]

    exemptionsstring[]required

    List of exemptions to apply when possible. Note exemptions shifts liability from the issuer to the merchant.

    Possible values: [TRA, LVT]

    reportFailurebooleanrequired

    If true, the notificationUrl will also receive webhooks for failed transactions. Otherwise, only successful transactions is notified.

  • ]
  • PointOfSaleListResponse
    {
    "page": 0,
    "perPage": 0,
    "lastPage": 0,
    "total": 0,
    "firstPageUrl": "string",
    "lastPageUrl": "string",
    "nextPageUrl": "string",
    "previousPageUrl": "string",
    "nextPage": 0,
    "previousPage": 0,
    "from": 0,
    "to": 0,
    "path": "string",
    "items": [
    {
    "pointOfSale": {
    "id": "0192473a-e381-705c-b61c-fc2ac9624afc",
    "name": "Store #42",
    "descriptor": "POS Copenhagen",
    "createdAt": "2024-10-01T10:38:14.658688472+02:00",
    "updatedAt": "2024-10-01T12:38:14.658688472+02:00"
    },
    "hostedConfiguration": {
    "instantCapture": "OFF",
    "scaMode": "SKIP",
    "timeout": 60,
    "notificationUrl": "https://example.com/notification",
    "successUrl": "https://example.com/success",
    "failureUrl": "https://example.com/failure",
    "retryUrl": null,
    "maxAttempts": 10,
    "processor": [
    "shift4",
    "nets"
    ],
    "exemptions": [
    "TRA",
    "LVT"
    ],
    "reportFailure": false
    }
    }
    ]
    }