v1

latestOpenAPI 3.1.0Payrails GmbH2026-07-2614905.7 MB
DropInLinks

List drop-in links

Fetch a paginated list of drop-in links for the given query parameters.

get/merchant/dropInLinks

Query parameters

filter[status]'enabled' | 'closed' | 'expired' | 'deleted'

Filter by drop-in link status.

filter[merchantReference]string

Filter by merchant reference.

filter[executionId]string uuid

Filter by workflow execution ID.

filter[createdAt]string

Filter by creation date. Supports range syntax, e.g. [2024-01-01T00:00:00Z,2025-01-01T00:00:00Z).

filter[updatedAt]string

Filter by last updated date. Supports range syntax, e.g. [2024-01-01T00:00:00Z,2025-01-01T00:00:00Z).

page[after]string

Cursor for paging results.

Search collection items after that cursor.

page[before]string

Cursor for paging results.

Search collection items before that cursor.

page[size]integer

Length of the collection to search.

Response

Success.

Example response

{
  "results": [
    {
      "amount": {
        "value": "12.50",
        "currency": "EUR"
      },
      "paidAmount": {
        "value": "12.50",
        "currency": "EUR"
      },
      "meta": {
        "order": {
          "storeId": "store-123",
          "reference": "order_3573894940903",
          "placement": {
            "country": {
              "code": "DE"
            },
            "city": "Berlin"
          },
          "deliveryAddress": {
            "city": "Ankeborg",
            "country": {
              "code": "SE"
            },
            "doorNumber": "1",
            "street": "Stargatan",
            "postalCode": "12345",
            "name": "Peter",
            "lastName": "Parker",
            "email": "notbatman@gmail.com"
          },
          "billingAddress": {
            "city": "Ankeborg",
            "country": {
              "code": "SE"
            },
            "doorNumber": "1",
            "street": "Stargatan",
            "postalCode": "12345",
            "name": "Bruno",
            "lastName": "Diaz",
            "email": "iambatman@gmail.com"
          },
          "lines": [
            {
              "id": "123",
              "quantity": 1,
              "taxPercentage": {
                "value": "5"
              },
              "description": "Delicious Beer.",
              "name": "Beer 1",
              "total": {
                "value": "100",
                "currency": "SEK"
              },
              "links": {
                "productUrl": "https://www.amazingmerchant.com/products/1",
                "imageUrl": "https://www.amazingmerchant.com/products/1.jpeg"
              }
            }
          ]
        },
        "customer": {
          "reference": "1231905323475",
          "name": "FirstName",
          "lastName": "LastName",
          "email": "someone@email.com",
          "type": "VIP",
          "country": {
            "code": "SE"
          }
        },
        "clientContext": {
          "ipAddress": "217.110.239.132",
          "osType": "ios",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36",
          "acceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
          "language": "nl_NL",
          "colorDepth": 24,
          "screenHeight": 723,
          "screenWidth": 1536,
          "timeZoneOffset": 0,
          "javaEnabled": true,
          "javaScriptEnabled": true,
          "cookiesAccepted": true,
          "origin": "https://merchant.com/checkout",
          "host": "merchant.com"
        },
        "vendor": {
          "reference": "vendor-123",
          "name": "Cool Restaurant"
        },
        "risk": {
          "score": "80",
          "skipPaymentProviderRules": false,
          "force3DS": true,
          "threeDSMode": "Default",
          "allowNative3DS": true,
          "sessionId": "34567890123",
          "exemptionIndicator": "lowValue"
        },
        "subscription": {
          "chargeFrequency": "P2D",
          "expiration": "2000-09-01"
        },
        "tags": {
          "customKey": "customValue"
        }
      }
    }
  ]
}