vellTRDocs
API ReferenceInvoicesPublic Invoice Read

Public Invoice Read

GET/v1/public/invoices/{hash}Optional

Buyer-facing read via the public link (the publicHash is the bearer; no merchant signature). First hit flips sent/activated β†’ viewed.

Authentication

Signature Pattern

None β€” public buyer endpoint, the invoice publicHash is the bearer.

Response Parameters

FieldTypeExample
publicHashstring"aB3xK9mN2pQ7rS1tV5wY8z"
merchantNamestring"Acme Store"
statusstring"viewed"
amountMinorinteger50000
currencystring"TRY"
lineItemsarray[…]
lineItems[].namestring"Monthly subscription"
lineItems[].qtyinteger1
lineItems[].unitPriceMinorinteger50000
lineItems[].lineTotalMinorinteger50000

Response Example

JSONResponse
{
  "publicHash": "aB3xK9mN2pQ7rS1tV5wY8z",
  "merchantName": "Acme Store",
  "status": "viewed",
  "amountMinor": 50000,
  "currency": "TRY",
  "lineItems": [
    {
      "name": "Monthly subscription",
      "qty": 1,
      "unitPriceMinor": 50000,
      "lineTotalMinor": 50000
    }
  ]
}

Status Codes

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
Try itMock
GEThttps://api.pay.sandbox.kvell.group