ربط زاتكا بـ Go

من فريق ماثل · آخر تحديث

طلب HTTP واحد من Go (net/http + database/sql): ماثل يبني الفاتورة ويوقّعها ويرسلها للهيئة، ويرجّع رد الهيئة والـ XML القانوني والـ PDF مع رمز QR.

١. جرّبه الحين (بدون مفتاح)

// go run main.go: the sandbox needs no key
package main

import ("bytes"; "encoding/json"; "fmt"; "net/http")

func main() {
	body, _ := json.Marshal(map[string]any{"environment": "sandbox", "pdf": true, "invoice": map[string]any{
		"type": "simplified", "line_items": []map[string]any{{"name": "قهوة", "quantity": 2, "price": "50.00"}}}})
	r, _ := http.Post("https://matheel.app/api/v1/invoices", "application/json", bytes.NewReader(body))
	var res map[string]any
	json.NewDecoder(r.Body).Decode(&res)
	fmt.Println(res["status"]) // reported
}

٢. الدالة الجاهزة بعد الدفع

تقفل صف الجهاز (عشان دفعتين بنفس اللحظة ما يكسرون السلسلة)، ترسل الفاتورة مع "pdf": true، وتحفظ device_token الجديد. أي رد غير 200 يرجّع الـ transaction والمفتاح القديم يظل صالح.

// database/sql + net/http.
func MatheelInvoice(db *sql.DB, items []map[string]any) (map[string]any, error) {
	tx, err := db.Begin()
	if err != nil { return nil, err }
	defer tx.Rollback() // no-op after Commit
	var token string
	if err := tx.QueryRow("SELECT token FROM matheel_device WHERE id = 1 FOR UPDATE").Scan(&token); err != nil { return nil, err }
	body, _ := json.Marshal(map[string]any{"device_token": token, "pdf": true,
		"invoice": map[string]any{"type": "simplified", "line_items": items}})
	req, _ := http.NewRequest("POST", "https://matheel.app/api/v1/invoices", bytes.NewReader(body))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer "+os.Getenv("MATHEEL_KEY"))
	r, err := http.DefaultClient.Do(req)
	if err != nil { return nil, err }
	defer r.Body.Close()
	var res map[string]any
	json.NewDecoder(r.Body).Decode(&res)
	if r.StatusCode != 200 { return nil, fmt.Errorf("matheel %d: %v", r.StatusCode, res) }
	if _, err := tx.Exec("UPDATE matheel_device SET token = $1 WHERE id = 1", res["device_token"]); err != nil { return nil, err }
	return res, tx.Commit()
}

٣. للإنتاج

أسئلة شائعة

أحتاج مكتبة Go خاصة بزاتكا؟

لا. ماثل API عادي بـ JSON: طلب HTTP واحد. التوقيع والـ XML والشهادة والإرسال للهيئة كلها عند ماثل.

وين أحفظ مفتاح الجهاز؟

صف واحد في قاعدة بياناتك (جدول matheel_device). بعد كل رد 200 احفظ device_token الجديد في نفس الـ transaction.

أجرّب قبل الاشتراك؟

إيه، على بيئة المطورين بدون مفتاح: الطلب تحت يرجّع رد الهيئة الحقيقي والـ PDF.

جرّبه الحين على بيئة المطورين

بدون مفتاح ولا تسجيل: الرد رد الهيئة الحقيقي، ومعه الفاتورة PDF عربي وإنجليزي ورمز QR.

ابدأ الأسعار