List Payment Links

GET

payment-link

curl "https://api.therius.io/v1/payment-link?merchantCode=MERCHANT_001&status=active&limit=50" \
  -H "Authorization: Bearer prv_production_your_key_here"

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "url": "<string>",
      "type": "one-time",
      "status": "active",
      "amountMode": "fixed",
      "amount": {
        "currency": "USD",
        "value": 4999,
        "exponent": 2
      },
      "amountMin": 123,
      "amountMax": 123,
      "subscriptionPlanId": 123,
      "checkoutConfigId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "description": "<string>",
      "reference": "<string>",
      "customerEmail": "<string>",
      "customerName": "<string>",
      "returnUrl": "<string>",
      "saveCardEnabled": true,
      "reusable": true,
      "maxUses": 123,
      "usesCount": 123,
      "environment": "production",
      "expiresAt": "2023-11-07T05:31:56Z",
      "usedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

GET /payment-link lists the payment links created in the environment of your API key, newest first. Filter with status (active, used, expired, cancelled). Use limit (1–100, default 25) to size a page. When more results exist, the response includes nextCursor — pass it as cursor to fetch the next page.

Example

curl "https://api.therius.io/v1/payment-link?merchantCode=MERCHANT_001&status=active&limit=50" \
  -H "Authorization: Bearer prv_production_your_key_here"

Authorizations

Authorization

string

header

required

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Query Parameters

merchantCode

string

Your merchant account identifier. Required if the key maps to more than one merchant account.

status

enum<string>

Filter by status.

Available options:

active,

used,

expired,

cancelled

limit

integer

default:25

1-100. Default 25.

Required range: 1 <= x <= 100

cursor

string

nextCursor from the previous page.

Response

A page of payment links, newest first

data

object[]

Show child attributes

nextCursor

string

Present when more results exist.

curl "https://api.therius.io/v1/payment-link?merchantCode=MERCHANT_001&status=active&limit=50" \
  -H "Authorization: Bearer prv_production_your_key_here"

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "url": "<string>",
      "type": "one-time",
      "status": "active",
      "amountMode": "fixed",
      "amount": {
        "currency": "USD",
        "value": 4999,
        "exponent": 2
      },
      "amountMin": 123,
      "amountMax": 123,
      "subscriptionPlanId": 123,
      "checkoutConfigId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "description": "<string>",
      "reference": "<string>",
      "customerEmail": "<string>",
      "customerName": "<string>",
      "returnUrl": "<string>",
      "saveCardEnabled": true,
      "reusable": true,
      "maxUses": 123,
      "usesCount": 123,
      "environment": "production",
      "expiresAt": "2023-11-07T05:31:56Z",
      "usedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

Payments

Payment Links

Tokenization

Subscriptions

Subscription Plans

SDK Session

List Payment Links

Example

Authorizations

Query Parameters

Response

​Example

Authorizations

Query Parameters

Response

Example