x402 API

שליחת מכתב מקוד, בתשלום ב-USDC

אפליקציות וסוכני AI יכולים לשלוח מכתב לכל מקום באוסטרליה ולשלם לפי מכתב ב-USDC באמצעות x402. בלי חשבון, בלי מפתח API ובלי מינוי: רק ארנק ולקוח HTTP.

10 USDC למכתב בדואר רגיל20 USDC למכתב ב-Express Post

מחיר אחד עד 20 עמודים לא מקופלים, כולל GST. התשלום ב-USDC ברשת Base, ועמלת ה-gas עלינו.

התחלה מהירה מפרט OpenAPI

למה לשלוח מכתבים דרך x402?

אותו מכתב כמו באתר, בתשלום דרך HTTP.

בלי חשבון ובלי מפתח API אין צורך להירשם. הקוד שלכם יוצר מכתב, מקבל מחיר ומשלם בתשלום USDC חתום.
מחיר קבוע למכתב 20 USDC ב-Express Post, לא מקופל במעטפת B4, או 10 USDC בדואר רגיל, מקופל כך שייכנס לתיבת הדואר. המחיר כולל הדפסה, מעטפה, דמי משלוח ומעקב עד 12 עמודים מקופלים או 20 לא מקופלים, ולאחר מכן 0.30 USDC לעמוד. כולל GST, ועמלת ה-gas עלינו.
אותו מכתב כמו באתר מודפס כפי שהועלה על נייר A4 במשקל 80 גרם למ״ר, עם מעקב, ונשלח באותו יום עסקים אם שולם עד 14:30 לפי שעון מלבורן.
החזר אם אי אפשר לשלוח אם איננו יכולים לשלוח את המכתב, אנחנו מחזירים לארנק המשלם את מלוא הסכום, ב-USDC. מכתב שאנחנו מבטלים מוחזר באותו אופן.

למי זה מיועד

סוכני AI סוכן שמטפל בסכסוך על פיקדון שכירות, בתביעת ביטוח או בתלונה לעירייה יכול לשלוח את המכתב בעצמו ולשלם מהארנק שלו.
אפליקציות וסקריפטים תוכנות לניהול נכסים, תוכנות משפטיות ותוכנות חיוב ששולחות מכתבים, בלי חשבון סוחר ובלי תוכנית חודשית.

חמש בקשות מעבירות מכתב מהקוד שלכם אל הדואר. אין חשבון ואין מפתח: התשלום הוא כל מה שאנחנו צריכים.

send-letter.sh

# 1. Create the letter
curl -X POST https://unopost.com.au/api/x402 \
  -H "Content-Type: application/json" \
  -d '{
  "fileName": "notice.pdf",
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "service": "express",
  "signature": true
}'

# 2. Upload the document to the uploadUrl you got back
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @notice.pdf

# 3. Poll until the status is ready_to_send, and check the price
curl https://unopost.com.au/api/x402/$JOB_ID

# 4. Ask to send it: the 402 says what to pay
curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send

# 5. Sign the payment with an x402 client, and send it again
curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send \
  -H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE"

נקודות קצה

נקודות הקצה יחסיות ל-https://unopost.com.au. הבקשות והתגובות הן ב-JSON; שגיאות מוחזרות כ-{"error": "..."}. לחומר העזר המלא: מפרט OpenAPI.

כתובת בסיס (Base URL)

https://unopost.com.au

POST/api/x402יצירת מכתב. ללא תשלום.PUTuploadUrlהעלאת המסמך לקישור החתום של המכתב.GET/api/x402/{jobId}קבלת הסטטוס, המחיר והמעקב של מכתב.POST/api/x402/{jobId}/sendתשלום ב-USDC, והמכתב עובר להדפסה.

יצירת מכתב

POST/api/x402

שלחו ב-POST את שם הקובץ, את כתובת הנמען ואת הכתובת להחזרה שלכם. תקבלו jobId, uploadUrl חתום, וכתובות URL לבדיקת המכתב ולתשלום עבורו.

גוף הבקשה

fileNamestring · חובה: שם הקובץ כולל הסיומת: ⁦.pdf, .doc, .docx, .jpg, .jpeg⁩ או ⁦.png⁩.
recipientAddress · חובה: הכתובת שאליה יישלח המכתב.
senderAddress · חובה: הכתובת להחזרה שלכם, המודפסת על המעטפה כדי שדואר שלא ניתן למסור יחזור אליכם.
servicestring · רשות: "express" ל-Express Post (ברירת המחדל) או "regular" לדואר רגיל.
duplexboolean · רשות: הדפסה דו-צדדית. ברירת המחדל היא false. תצהירים סטטוטוריים (statutory declarations) מודפסים תמיד בצד אחד.
monoboolean · רשות: הדפסה בשחור-לבן. ברירת המחדל היא false: מסמך שיש בו צבע מודפס בצבע.
stapleboolean · רשות: הידוק העמודים פעם אחת בפינה השמאלית העליונה. רק למסמכים של עד 12 עמודים; מסמך ארוך יותר נדחה בעת תמחורו. ברירת המחדל היא false.
foldboolean · רשות: ל-Express Post בלבד: קיפול המכתב לתוך מעטפת C5 במקום משלוח ללא קיפול במעטפת B4, ללא תוספת תשלום. השדה אינו חל על מסמכים של יותר מ-20 עמודים, שנשלחים לא מקופלים. מכתבים בדואר רגיל מקופלים תמיד.
signatureboolean · רשות: חתימה בעת המסירה, בתוספת 6 USDC, בכל אחד מהשירותים. עם regular, המכתב נשלח בדואר רשום.

כתובת

הנמען חייב להיות באוסטרליה. הכתובת להחזרה יכולה להיות בכל מקום: ציינו את המדינה שלה, והמיקוד שלה הופך לרשות. כל שורה יכולה להכיל עד 40 תווים.

namestring · רשות: שמו המלא של האדם.
companystring · רשות: עסק או ארגון.
line1string · חובה: כתובת הרחוב, או תא דואר כגון "PO Box 123".
line2string · רשות: שורת כתובת שנייה.
suburbstring · חובה: הפרבר או העיירה.
statestring · רשות: באוסטרליה אפשר להשמיט: המדינה (state) נקבעת לפי המיקוד. אם היא מצוינת, אחד מהערכים ACT, NSW, NT, QLD, SA, TAS, VIC או WA, בהתאם למיקוד.
postcodestring · חובה: ארבע ספרות.
countrystring · רשות: לכתובת להחזרה בלבד. עבור אוסטרליה יש להשמיט.

בקשה

curl -X POST https://unopost.com.au/api/x402 \
  -H "Content-Type: application/json" \
  -d '{
  "fileName": "notice.pdf",
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "service": "express",
  "signature": true
}'

תגובה 200

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "uploadUrl": "https://unopost.com.au/uploads/019d7a7f-a183-752d-9b3b-11511179033b/notice.pdf?Expires=...&Signature=...&Key-Pair-Id=...",
  "statusUrl": "/api/x402/019d7a7f-a183-752d-9b3b-11511179033b",
  "sendUrl": "/api/x402/019d7a7f-a183-752d-9b3b-11511179033b/send",
  "status": "awaiting_upload"
}

העלאת המסמך

PUTuploadUrl

שלחו ב-PUT את הבייטים הגולמיים של הקובץ אל uploadUrl בתוך 15 דקות. עד 50 MB ו-80 עמודים. העריכה על דפי A4 מתחילה מיד עם סיום ההעלאה; אין צורך בקריאה נוספת.

בקשה

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @notice.pdf

אחזור מכתב

GET/api/x402/{jobId}

המתנה למחיר

בצעו polling מדי כמה שניות עד שה-status הוא ready_to_send. התגובה כוללת אז את מספר העמודים, את המחיר ב-payment, את ה-sendUrl, ו-previewUrl לקובץ ה-PDF המוכן להדפסה, לבדיקה לפני התשלום.

fold נקבע כעת לפי השירות, true לדואר רגיל ו-false ל-Express Post, ו-duplex עשוי להיות false: תצהירים סטטוטוריים (statutory declarations) מודפסים בצד אחד. מכתב בדואר רגיל של יותר מ-12 עמודים נדחה בעת התמחור.

מעקב אחרי המכתב

המשיכו ב-polling, בתדירות נמוכה יותר, עד שהמכתב במצב posted ולאחר מכן delivered. לא נשלחות הודעות דוא״ל; כל עדכון מופיע בסטטוס.

בקשה

curl https://unopost.com.au/api/x402/$JOB_ID

תגובה 200 · ready_to_send

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "service": "express",
  "duplex": false,
  "mono": false,
  "fold": false,
  "signature": true,
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "pageCount": 3,
  "status": "ready_to_send",
  "previewUrl": "/preview/019d7a7f-a183-752d-9b3b-11511179033b/notice.pdf?Expires=...&Signature=...&Key-Pair-Id=...",
  "payment": {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amountAtomic": "20000000",
    "amountDisplay": "20 USDC",
    "payTo": "0x1111111111111111111111111111111111111111",
    "expiresAt": "2026-09-25T02:15:00Z"
  },
  "sendUrl": "/api/x402/019d7a7f-a183-752d-9b3b-11511179033b/send"
}

תגובה 200 · posted

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "service": "express",
  "duplex": false,
  "mono": false,
  "fold": false,
  "signature": true,
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "pageCount": 3,
  "status": "posted",
  "providerReference": "LTR-8F3A21C9"
}

תשלום ומשלוח

POST/api/x402/{jobId}/send

שלחו POST אל sendUrl ללא תשלום. התגובה היא 402 Payment Required, ודרישות התשלום מקודדות ב-base64 בכותרת PAYMENT-REQUIRED.

חתמו על התשלום כפי שמתאר פרוטוקול x402 (או תנו לספריית לקוח של x402 לעשות זאת) ושלחו את הבקשה שוב עם ה-payload בכותרת PAYMENT-SIGNATURE. אנחנו מאמתים וסולקים את התשלום, והמכתב עובר להדפסה. הכותרת PAYMENT-RESPONSE מכילה את פרטי הסליקה.

קיבלתם 409 עם job not ready to send מיד אחרי ready_to_send? המתינו רגע ונסו שוב. קריאה נוספת לאחר התשלום מחזירה את הסטטוס בלי לחייב פעמיים.

בקשה

curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send

תגובה 402

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6Mi...

{
  "error": "payment required"
}

כותרת PAYMENT-REQUIRED, לאחר פענוח base64

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000000",
      "payTo": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

בקשה

curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send \
  -H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE"

תגובה 202

HTTP/2 202
payment-response: eyJzdWNjZXNzIjp0cnVlLC...

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "status": "sending"
}

סטטוסים

awaiting_upload: ממתין לקובץ.
processing: המסמך נערך על דפי A4 ומתומחר.
ready_to_send: תומחר וממתין לתשלום. הצעת המחיר תקפה ל-7 ימים.
sending: שולם, ונמצא בתור להדפסה.
retrying: ההדפסה נתקלה בבעיה; אנחנו מנסים שוב באופן אוטומטי.
posted: הודפס והופקד ב-Australia Post.
delivered: נמסר על ידי Australia Post. המסמך נמחק בעת השיגור.
failed: לא נשלח; הסיבה מופיעה ב-error, למשל הצעת מחיר שפקעה בלי ששולמה. מכתב ששולם ואי אפשר לשלוח אותו מוחזר במלואו.
refunded: התשלום הוחזר לארנק ששילם עבורו.

שגיאות

400: בקשה לא תקינה: למשל שדה חסר, סוג קובץ שאינו נתמך, שורת כתובת של יותר מ-40 תווים, מיקוד שאינו שייך למדינה (state), חתימה בעת המסירה בדואר רגיל, או מכתב בדואר רגיל של יותר מ-12 עמודים.
402: נדרש תשלום, או שלא ניתן היה לאמת או לסלוק את התשלום. הסיבה מופיעה ב-error.
404: אין מכתב עם jobId זה.
409: job not ready to send: המתינו ל-ready_to_send ונסו שוב. quote expired: צרו את המכתב מחדש.

שאלות נפוצות

מה זה x402?

פרוטוקול פתוח לתשלום דרך HTTP. השרת משיב 402 Payment Required עם מחיר; הלקוח חותם על תשלום במטבע יציב ושולח את הבקשה שוב. בלי חשבון, בלי כרטיס ובלי חשבונית.

מה צריך?

ארנק ברשת Base עם מספיק USDC, ולקוח HTTP. אין צורך ב-ETH ל-gas: התשלום הוא הרשאת העברה חתומה של USDC, ואנחנו נושאים בעמלת הרשת.

כמה עולה מכתב?

20 USDC ב-Express Post עד 20 עמודים, ולאחר מכן 0.30 USDC לעמוד, או 10 USDC בדואר רגיל למכתב של עד 12 עמודים, כולל GST. חתימה בעת המסירה עולה 6 USDC נוספים בכל אחד מהשירותים; דואר רגיל עם חתימה הוא דואר רשום, 16 USDC. מעקב, הדפסה דו-צדדית ובשחור-לבן, הידוק של עד 12 עמודים, וקיפול מכתב Express Post לתוך מעטפת חלון DL הם חינם. תגובת הסטטוס מציגה את המחיר המדויק לפני התשלום.

אפשר לבדוק את המכתב לפני התשלום?

כן. כשהוא מוכן לשליחה, previewUrl הוא קובץ ה-PDF המוכן להדפסה, ערוך על דפי A4 בדיוק כפי שיודפס. אין חיוב עד שאתם משלמים.

מתי המכתב נשלח, וכמה זמן לוקח לו להגיע?

מכתבים ששולמו עד 14:30 לפי שעון מלבורן ביום עסקים נשלחים באותו יום; מאוחרים יותר, ביום העסקים הבא. Express Post מגיע בדרך כלל ביום העסקים הבא בתוך רשת Express Post, ודואר רגיל בתוך 3 עד 7 ימי עסקים.

מה קורה אם אי אפשר לשלוח את המכתב?

הסטטוס שלו משתנה ל-failed ואנחנו מחזירים את מלוא הסכום ב-USDC לארנק המשלם, בין שהמכתב נכשל ובין שביטלנו אותו. בכל עניין אחר, כתבו אל support@unopost.com.au וציינו את ה-jobId.

מה קורה למסמך שלי?

הוא מוצפן בזמן ההעברה ונמחק לצמיתות, יחד עם העותק המוכן להדפסה, לאחר שהמכתב מופקד ב-Australia Post. אם לא שולם עבור מכתב או שאי אפשר לשלוח אותו, הוא נמחק לאחר 14 יום.

לאן אפשר לשלוח מכתבים?

לכל כתובת באוסטרליה, כולל תאי דואר (PO Box), בכל מדינה וטריטוריה. ה-API אינו שולח לחו״ל.

מי אחראי למה שסוכן שולח?

אתם. כל מכתב ששולם מהארנק שלכם הוא שלכם, כולל מכתב שסוכן כתב ושלח לפי הוראותיכם, ועליכם להיות בעלי הזכות לשלוח את תוכנו. התנאים שלנו מפרטים מה אסור לשלוח בדואר: התחזות, הטרדה, הונאות, פרסום המוני שלא התבקש, וכל דבר שמפר צו בית משפט. אנחנו מבטלים מכתבים שמפרים כללים אלה, ומחזירים עבורם את מלוא הסכום. אם אתם שולחים בשם מישהו אחר, אתם אחראים למסמך שלו כאילו היה שלכם.

מחירים

פריט	מחיר
דואר רגיל, מקופל כך שייכנס לתיבת הדואר: עד 12 עמודים	10 USDC
דואר רשום, דואר רגיל עם חתימה בעת המסירה: עד 12 עמודים	16 USDC
Express Post, לא מקופל במעטפת B4: 20 עמודים כלולים, ולאחר מכן 0.30 USDC לכל עמוד נוסף	20 USDC
Express Post עם חתימה בעת המסירה: 20 עמודים כלולים, ולאחר מכן 0.30 USDC לכל עמוד נוסף	26 USDC
מעקב, הדפסה בצבע, דו-צדדית או בשחור-לבן, והידוק	חינם
עמלת רשת (gas)	עלינו

המחירים ב-USDC ברשת Base. המחיר נקבע לאחר שהמסמך נערך על דפי A4; הצעות המחיר תקפות ל-7 ימים.

המחירים עשויים להשתנות. השימוש בשירות זה כפוף לתנאי השירות ולמדיניות הפרטיות שלנו.