יצירת קישור תשלום מאובטח ללקוח

curl --request POST \ --url https://api.splitz.co.il/mcp/generate_payment_link \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "payment_link_uid": "pl_1234567890abcdef", "customer_email": "customer@example.com" } '

Authorizations

Authorization

string

header

required

אימות באמצעות Bearer Token. יש לשלוח כותרת Authorization עם הערך Bearer <SHOP_API_KEY>.

דוגמה:

Authorization: Bearer sk_live_1234567890abcdef

המפתח הוא מפתח ה-API של החנות (Shop Model: api_key) שניתן למצוא בפאנל הניהול של Splitz.

Body

application/json

פרטי הבקשה ליצירת קישור תשלום

payment_link_uid

string

required

מזהה ייחודי (UID) של עמוד/קישור התשלום במערכת Splitz. ניתן לקבל מזהה זה מהפאנל או דרך ה-API של ניהול קישורי תשלום.

Required string length: 1 - 100

Example:

"pl_1234567890abcdef"

customer_email

string<email>

required

כתובת אימייל תקינה של הלקוח אליו יצורף הקישור. משמש למעקב, זיהוי ושליחת התראות על התשלום.

Pattern: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

Example:

"customer@example.com"

Response

קישור התשלום נוצר בהצלחה

success

boolean

required

מצב ההצלחה של הפעולה (תמיד true במקרה של תגובה 200)

Example:

true

url

string<uri>

required

כתובת URL מלאה של קישור התשלום המאובטח. הקישור כולל את ה-payment_link_uid וטוקן ייחודי ארוך מוצפן. יש לשלוח קישור זה ללקוח (דרך אימייל, SMS וכו').

Example:

"https://app.splitz.co.il/pay-link/pl_1234567890abcdef/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6"