Add a pricing option

Adds a pricing option to an existing offer — the offer and its checkoutUrl stay the same, only the option list grows. This replaces the removed POST /paylinks/{paylinkId}/variants, which cloned an entire plan and minted a second, unrelated link.

Authorization

apiKey

X-API-Key<token>

Your merchant API key, shown once at creation in the dashboard (Settings → API key).

In: header

Path Parameters

offerId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

label?string

Names this option at checkout when the offer has several (e.g. "Monthly" vs "Annual"). Must be unique within an offer. Omit and the checkout derives a label from the billing interval.

Length1 <= length <= 100

amount*string

How much of currency this option costs, as a decimal string — e.g. amount "30" with currency "USD" means $30.00. This pair is the shop-window price; it is NOT necessarily the number of tokens pulled on-chain (see currency's description for that). Minimum $1.00 USD equivalent. IMMUTABLE once created: an existing subscriber's on-chain authorization is sized against the token amount derived from this, so it can never be edited. To charge differently, add another pricing option.

Match^\d+(\.\d+)?$

currency?PlanCurrency

What amount is denominated in — this decides whether amount itself is the on-chain charge or just the price it is converted from. A stablecoin ticker (USDC, USDT, EURC) means amount IS the token amount: currency "USDC" + amount "30" pulls exactly 30 USDC, every cycle. A fiat code (USD, BRL, MXN, COP, ARS, ...) means amount is a fiat price that gets converted to each entry in acceptedTokens ONCE, at creation, using the exchange rate at that moment — currency "USD" + amount "30" on a plan accepting usdc-base freezes to however many USDC $30 buys right then (see acceptedTokens in the response for that frozen figure), and the buyer pays that same token amount every cycle afterwards regardless of what the USD/USDC rate does later.

Default"USD"

Value in

"USD"
"EUR"
"BRL"
"GBP"
"MXN"
"COP"
"ARS"
"CLP"
"PEN"
"UYU"
"CAD"
"AUD"
"JPY"
"CHF"
"AED"
"SGD"
"HKD"
"INR"
"TRY"
"ZAR"
"USDC"
"USDT"
"EURC"

acceptedTokens*array<>

Every chain+token combination this option accepts, as catalog keys from GET /v1/currencies. The buyer picks one at checkout — both the chain AND the token. Each gets its own frozen amount. Must not repeat.

Items1 <= items <= 13

billing*|

One-time or recurring, and how often. A one-time option produces a Payment; a recurring one produces a Subscription that then produces a Payment per cycle. IMMUTABLE once created, same reason as amount.

splitEvm?

Split each EVM payout among several recipients, via a 0xSplits contract deployed per accepted EVM chain. Addresses must be EVM (0x…). Tidepay's own take rate is injected as an extra recipient and your percentages are rescaled to fit. IMMUTABLE — the recipient list is baked into the contract address subscribers authorize against.

splitSolana?

Split each Solana payout among several recipients. Solana has no split contract — the operator fans out one transfer per recipient at distribute time. Addresses must be Solana (base58). Same take-rate injection and immutability as splitEvm.

merchantDestinationWallet?|

Payout address for this option. Falls back to your registered settlement wallet for the chosen token.

trialDays?integer

Range0 <= value <= 365

maxCycles?integer

Range0 < value <= 100000

maxFailedCycles?integer

Range0 < value <= 1000

Response Body

`application/json`

curl -X POST "https://example.com/offers/string/pricing" \  -H "Content-Type: application/json" \  -d '{    "amount": "30",    "acceptedTokens": [      "usdc-base"    ],    "billing": {      "type": "one_time"    }  }'

{  "id": "offer_01j8x2q3r4s5t6u7v8w9x0y1z2",  "name": "Pro",  "description": "string",  "imageUrl": "string",  "identifier": "pro",  "productRef": "SKU-1234",  "checkoutUrl": "https://tidepay.cc/pay/a8f3k2",  "pricing": [    {      "id": "price_01j8x2q3r4s5t6u7v8w9x0y1z3",      "label": "Monthly",      "amount": "30",      "currency": "USDC",      "billing": {        "type": "recurring",        "interval": "month"      },      "acceptedTokens": [        {          "tokenKey": "usdc-polygon",          "chainId": 8453,          "amountBaseUnits": "30000000"        }      ],      "trialDays": 7,      "maxCycles": 12,      "maxFailedCycles": 3,      "active": true    }  ],  "active": true,  "availableQuantity": 100,  "redeemedCount": 12,  "expiresAt": "2026-08-19T14:32:00.000Z",  "afterCompletion": {    "property1": null,    "property2": null  },  "features": [    {      "property1": null,      "property2": null    }  ],  "collectFields": {    "property1": null,    "property2": null  },  "allowedPaymentMethods": {    "property1": null,    "property2": null  },  "metadata": {    "orderId": "12345"  },  "reference": "ORDER-2024-001",  "isSandbox": true,  "createdAt": "2026-08-19T14:32:00.000Z",  "updatedAt": "2026-08-19T14:32:00.000Z"}

Add a pricing option

Authorization

Path Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

404application/json

409application/json

429application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`