מסמך לכל תשלום שהושלם בטופס Gravity Forms או WPForms, והצעת מחיר מטפסי Elementor.
התקנה (5 דקות)#
- התקינו את התוסף לפי ההוראות הכלליות והדביקו את מפתח ה-API בלשונית חיבור.
- פתחו את הלשונית של התוסף שלכם ובצעו את השלבים שלו.
Gravity Forms ו-WPForms (טפסים עם תשלום)#
- סמנו הפעלת האינטגרציה, בחרו סוג מסמך ושמרו.
- מזהי טפסים — ריק אומר כל הטפסים עם תשלום. להגבלה, כתבו מספרים בפסיק:
3,7. - מזהה שדה השם ומזהה שדה המייל — ריק אומר זיהוי אוטומטי של השדה הראשון מהסוג. לקביעה ידנית, כתבו את המזהה של השדה בטופס.
- בצעו תשלום בדיקה דרך הסליקה של הטופס. המסמך מופק בסיום התשלום.
שורות המסמך נלקחות משדות המוצר. אם הסכום שלהן שונה ממה שנגבה (קופון, מס, עמלת תוסף), נוצרת שורה אחת בשם הטופס עם הסכום ששולם.
Elementor Forms (הצעת מחיר)#
טופס Elementor לא גובה תשלום, לכן האינטגרציה מפיקה הצעת מחיר או חשבון עסקה, ולא חשבונית מס. היא כבויה כברירת מחדל.
- שמות הטפסים — שורה לכל טופס, בדיוק כפי שהוא מופיע בשדה "שם הטופס" בהגדרות הטופס.
- מזהה שדה הסכום — ה-ID של שדה המספר בטופס. בלי שדה סכום הטופס מדולג.
- שדה השם ושדה המייל — ברירת המחדל
nameו-email. - סמנו הפעלת האינטגרציה, בחרו הצעת מחיר או חשבון עסקה ושמרו.
Developer reference#
| Integration | Hook | Source |
|---|---|---|
| Gravity Forms | gform_post_payment_completed( $entry, $action ); $action = type, amount, transaction_type, transaction_id, subscription_id, entry_id, payment_status, note | https://docs.gravityforms.com/gform_post_payment_completed/ |
| WPForms (Stripe) | wpforms_stripe_process_complete( $fields, $form_data, $payment_id, $payment, $subscription, $customer ) | https://wpforms.com/developers/wpforms_stripe_process_complete/ |
| WPForms (PayPal Standard) | wpforms_paypal_standard_process_complete( $fields, $form_data, $payment_id, $data ) | https://wpforms.com/developers/wpforms_paypal_standard_process_complete/ |
| WPForms (other add-ons) | wpforms_process_complete( $fields, $entry, $form_data, $entry_id ) (forms with Stripe / PayPal Standard enabled are skipped here) | https://wpforms.com/developers/wpforms_process_complete/ |
| Elementor Pro | elementor_pro/forms/new_record( $record, $ajax_handler ) | https://developers.elementor.com/docs/hooks/forms |
Plugin classes: class-slk-integration-gravityforms.php, class-slk-integration-wpforms.php,
class-slk-integration-elementor.php. Host guards: GFForms/GFCommon, function_exists('wpforms'),
ELEMENTOR_PRO_VERSION.
- Amount: Gravity Forms
$action['amount']; WPForms Stripe$payment->amount(minor units = agorot), PayPalmc_gross, otherwise thepayment-totalfield'samount_raw. Lines come fromGFCommon::get_product_fields()/payment-*fields only when they add up (within ₪1) to the paid amount. - apiIdentifier:
gf-<host>-<entry id>[-<hash of transaction id>](a subscription's renewals share an entry id),wpforms-<host>-stripe-<id>/paypal-<id>/entry-<id>,elementor-<host>-<uuid>. - Elementor: docType 7 (הצעת מחיר) or 5 (חשבון עסקה), no payment rows, only when the form name matches the configured list and an amount field is set. Each submission gets a UUID as its idempotency key.
wpforms_process_payment_savedis intentionally not used: it is not in the official WPForms developer docs.
Troubleshooting#
- אין מסמך אחרי תשלום בטופס: ודאו שהאינטגרציה מסומנת, ושמזהה הטופס ברשימה (או שהרשימה ריקה).
- שם הלקוח מופיע "לקוח/ה": השדה לא זוהה. הזינו ידנית את מזהה שדה השם.
- Elementor לא מפיק: בדקו שהשם ברשימה זהה לשם הטופס ושמזהה שדה הסכום נכון. ביומן תופיע שורה "דולג".
- כשל 401/403: ראו פתרון תקלות כלליות.