Generate Personalized Link

This endpoint allows you to generate a personalized checkout link based on an existing checkout link created in the Zotlo Dashboard. You can customize the visual content (images & text), pricing (for one-time payments), and additional metadata to create a user-specific checkout flow.

Use this endpoint to run targeted campaigns, pass user attributes, app-2-web scenarios or integrate marketing parameters (MMPs, tracking IDs, Adjust/Appsflyer data, etc.).

The service operates using the POST method.

Method	POST
URL	https://api.zotlo.com/v2/app-to-web/one-link

Request Parameters

Field	Type	Description
applicationKey	Required	The unique key provided for your project. Available under Zotlo Dashboard → Developer Tools → Checkout SDK.
checkoutLinkId	Required	ID of the checkout link to be customized. A checkout link must first be created in the Zotlo Dashboard.
subscriberIpAddress	Required	IP address of the user. When country-based pricing rules are enabled, Zotlo uses this IP as a signal to determine the appropriate price and currency on the checkout page.
language	Required	Checkout language (e.g., EN, TR).
subscriberId	Optional	The email or phone number of the user.
productImage	Optional	Custom product image URL.
additionalText	Optional	Additional text displayed on checkout.
packageName	Optional	Custom display name of the package.
customPrice	Optional	Custom price for one-time purchases.
customCurrency	Optional	Currency for custom pricing.
customParameters	Optional	Additional metadata (MMP parameters, tracking IDs).

Sample Request

POST https://api.zotlo.com/v2/app-to-web/one-link HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: en

{
  "applicationKey": "989e9bc1fbbbc1b82e18548c4577ed3f24c9dc39cc416db5",
  "subscriberId": "",
  "subscriberIpAddress": "37.24.56.13",
  "language": "en",
  "productImage": "",
  "additionalText": "Zotlo Test",
  "checkoutLinkId": "123",
  "packageName": "Package Name Test",
  "customPrice": "",
  "customCurrency": "",
  "customParameters": {
    "mmp": {
      "appsflyer_id": "id6446176688"
    }
  }
}

You can find your AccessKey and AccessSecret in the Zotlo Panel under Developer Tools → API Keys

Sending ApplicationId is optional.

Successful Response

{
    "meta": {
        "requestId": "68b5fbdd6f-hpwjc-REQ-683dbb1c4c569",
        "httpStatus": 200
    },
    "result": {
        "oneLink": "https://checkout.zotlo.com/payment/6e7ac760800a071338d6b81b9dc65b9ffbbdd18de17e4cb9a1"
    }
}

Key Response Fields

Field	Description
onelink	Personalized link to share

Failed Response

All failed responses follow the same standard error format. (See: Error Handling)