public

GET /v1/pay/invoices/{token}

An invoice, for the person paying it. Unauthenticated.

ሁሉም የ public ማጠናቀቂያ ነጥቦች

developer ሰነዶች ሁሉ

ማረጋገጫ

ይህ ማቆሚያ (endpoint)ይፋዊ ነው። ምንም ምስክርነት (credential) ወይም ድርጅት አይወስድም — የራሳችን የግብይት ጣቢያ እና የAI መልስ ሞተሮች የሚያነቡት ነው።

ይህ ኤንድፖይ መክፈቻ (endpoint) የድርጅት መታወቂያ (organisation id) አይወስድም። የእርስዎ ቁልፍ (key) እሱ የሚመለከተውን ድርጅት አስቀድሞ ይለያል፣ እና ምላሹም ለዚሁ የተወሰነ ነው።

ሞክሩት

በቅንፍ ውስጥ ያለውን ማንኛውንም ነገር በራስዎ እሴቶች ይተኩ፣ እና ቁልፍ ቦታ ያዢውን ከዳሽቦርድዎ በመጣ ቁልፍ ይተኩ።

curl -X GET https://api.zinndigital.com/v1/pay/invoices/{token}

ገብተዋል? የመቆጣጠሪያ ማዕከልዎ ውስጥ ያለው የኤፒአይ ኮንሶል ትክክለኛውን የድርጅት መታወቂያዎን እና የራስዎን ቁልፍ ይሞላል፣ እና ትክክለኛውን ምላሽ ማየት እንዲችሉ ጥያቄውን በቀጥታ ከሚሰራው ኤፒአይ ጋር ያካሂደዋል። ይህን ኤንድፖይንት በAPI ኮንሶል ውስጥ ይክፈቱ

ዝርዝሮች

No authentication and no session. The payer may have no account here at all; the capability token in the path is the whole authorisation and it reaches exactly one invoice. Every string in the response is already translated into the recipient's locale — the one stored on the document, not the one of whoever's browser opened the link. The page that renders this holds no copy of its own. Every refusal answers with the same sentence whatever the cause — a wrong token, a draft, a withdrawn or an unknown one. Distinguishing them would confirm to a stranger that a token is real, which is the oracle that makes a capability URL worth sweeping.

መለኪያዎች

ስምዓይነትየሚያስፈልግምንነቱ
token (path)stringአዎ

ምላሽ

ስምዓይነትየሚያስፈልግምንነቱ
referencestringአዎ
statusstring<sent, paid>አዎ
currencystringአዎ
issue_datestringአዎ
due_datestringአይ
due_date_displaystringአይThe due date in the reader's own convention, already formatted.
buyerobjectአዎ
linesobject[]አዎ
subtotalstringአዎ
tax_totalstringአዎ
totalstringአዎ
total_minorintegerአይ
amount_duestringአዎZero once paid. Computed, never stored — a page saying money is due beside a Paid badge is the worst thing this can render.
amount_due_minorintegerአዎ
notesstringአይ
labelsobjectአዎEvery label on the document, in the reader's language.
localestringአይ
directionstring<ltr, rtl>አዎ
payablebooleanአዎ

ይህ ማብቂያ ሊመልሳቸው የሚችሉ ስህተቶች

404 · 429