Skip to content

getMyUnusedLinks

List your pending (unpaid) payment links.

Request

POST /api/v2/getMyUnusedLinks

Headers

Header Required Description
token Yes Your API Key
Content-Type Yes application/json

Body Parameters

Field Type Required Default Description
limit integer No 10 Maximum number of results to return
search string No — Filter by recipient_note (partial match)

Response

Success

{
  "data": [
    {
      "linktopay_id": "99290",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "recipient_note": "Test regular link",
      "amount": "25.00",
      "is_cancelled": "No",
      "recipients": null,
      "is_split_link": "false",
      "pay_link": "https://app.secpaid.com/payment?link_id=OTkyOTA=",
      "qr_img": "https://quickchart.io/chart?chl=https://app.secpaid.com/payment?link_id=OTkyOTA=&chs=300x300&cht=qr",
      "transaction_type": "Basic"
    },
    {
      "linktopay_id": "99289",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "recipient_note": "Test-Ala",
      "amount": "35.39",
      "is_cancelled": "No",
      "recipients": "[{\"token\":\"testuser-a\",\"share\":10}]",
      "is_split_link": "true",
      "pay_link": "https://app.secpaid.com/payment?link_id=OTkyODk=",
      "qr_img": "https://quickchart.io/chart?chl=https://app.secpaid.com/payment?link_id=OTkyODk=&chs=300x300&cht=qr",
      "transaction_type": "Split"
    }
  ],
  "ResponseCode": 1,
  "ResponseMsg": "List retrived successfully",
  "Result": "True",
  "ServerTime": "CEST"
}

Response Fields (per item)

Field Type Description
linktopay_id string Link ID
amount string Payment amount
recipient_note string Note you set on the link
is_cancelled string Whether the link was cancelled
recipients string|null JSON-encoded recipients (null for basic links)
is_split_link string "true" / "false"
pay_link string Payment URL
qr_img string QR code image URL
transaction_type string "Basic" or "Split"

Examples

curl -X POST https://app.secpaid.com/api/v2/getMyUnusedLinks \
  -H "Content-Type: application/json" \
  -H "token: YOUR_API_KEY" \
  -d '{"limit": 20, "search": "Invoice"}'

const response = await fetch("https://app.secpaid.com/api/v2/getMyUnusedLinks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "token": "YOUR_API_KEY"
  },
  body: JSON.stringify({ limit: 20, search: "Invoice" })
});

$response = Http::withHeaders([
    'token' => 'YOUR_API_KEY',
])->post('https://app.secpaid.com/api/v2/getMyUnusedLinks', [
    'limit' => 20,
    'search' => 'Invoice',
]);

Notes

  • Returns only links with status Unused belonging to your account
  • Results are ordered by creation date (newest first)
  • Use search to filter by the recipient_note field
  • Both basic and split links appear in the same list — check transaction_type to distinguish