public

GET `/v1/pay/invoices/{token}`

An invoice, for the person paying it. Unauthenticated.

المصادقة

هذه نقطة النهاية عامة. فهي لا تتطلب أي بيانات اعتماد ولا أي مؤسسة - بل هي ما تقرؤه مواقعنا التسويقية ومحركات الإجابة بالذكاء الاصطناعي الخاصة بنا.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

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`	نعم	—

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`reference`	`string`	نعم	—
`status`	`string<sent, paid>`	نعم	—
`currency`	`string`	نعم	—
`issue_date`	`string`	نعم	—
`due_date`	`string`	لا	—
`due_date_display`	`string`	لا	The due date in the reader's own convention, already formatted.
`buyer`	`object`	نعم	—
`lines`	`object[]`	نعم	—
`subtotal`	`string`	نعم	—
`tax_total`	`string`	نعم	—
`total`	`string`	نعم	—
`total_minor`	`integer`	لا	—
`amount_due`	`string`	نعم	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_minor`	`integer`	نعم	—
`notes`	`string`	لا	—
`labels`	`object`	نعم	Every label on the document, in the reader's language.
`locale`	`string`	لا	—
`direction`	`string<ltr, rtl>`	نعم	—
`payable`	`boolean`	نعم	—

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

404 · 429

GET /v1/pay/invoices/{token}