Overview

The My Billing module enables merchants to manage Standing Orders (STO) - recurring subscription-based payments.

Key capabilities:

• Create and manage recurring payment schedules (weekly, monthly, quarterly, half-yearly, yearly)
• Support for credit card payments via tokenization
• Support for MASAV direct debit (Israeli bank clearing)
• Price Index Linkage - automatic price adjustments based on the Consumer Price Index (CPI)
• Real-time transaction notifications via webhook
• Automatic email alerts to end-customers on charge failures
• Advanced STO management via API

Authentication

All API requests require authentication headers. Detailed explanation can be found in Authentication Documentation.

Notifications & Alerts

The My Billing module provides two notification mechanisms to help you manage your recurring payments effectively.

Configuration

All notification settings are configured in the my.tranzila.com portal: Settings → Terminal → My-Billing

Transaction Notification Endpoint

Receive real-time server-side notifications (POST) for every STO transaction processed by the My Billing system. This allows you to update your systems immediately when charges are executed.

Setup: Enter your endpoint URL in the "Transaction Notification Endpoint" field in the My Billing settings.

Payload Example:

{
  "supplier": "myterminal",
  "sto_external_id": "352885",
  "sum": "59.00",
  "currency": "ILS",
  "Response": "000",
  "ConfirmationCode": "0000000",
  "TranzilaTK": "X543c4c9214a1882312",
  "index": "2359",
  "Tempref": "27680001",
  "expdate": "0426",
  "cardtype": "5",
  "DBFcard": "5",
  "DBFcardtype": "1",
  "cred_type": "1",
  "tranmode": "A1705",
  "contact": "Customer Name",
  "email": "customer@example.com",
  "myid": "123456789",
  "pdesc": "Subscription - Basic Plan monthly",
  "json_purchase_data": "[{\"product_name\":\"Subscription - Basic Plan monthly\",\"product_quantity\":\"1.00\",\"product_price\":29.5}]",
  "Responseid": "3",
  "Responsesource": "0",
  "Responsecvv": "0",
  "cardaquirer": "1",
  "cardissuer": "1",
  "DBFIsForeign": "0",
  "IMaam": "1"
}

Key Fields:

Token Correction Notification (Automatic Email)

When a recurring charge fails due to a credit card issue, the system can automatically send an email to the end-customer with a secure link to update their credit card details.

How it works:

1. A charge attempt fails due to a card issue
2. The system automatically sends a bilingual email (Hebrew and English) to the customer
3. The email contains a secure link to Tranzila's iframe payment page
4. The customer enters new credit card details
5. A new token is created and associated with the STO
6. Failed charges are automatically retried

Email Contents:

• Business name and contact information
• Description of the failed charge
• Last 4 digits of the problematic card
• Secure link to update credit card
• Phone number for customer support (configurable)

Failure Types That Trigger the Email: The email is sent only for failures that require card replacement:

• Stolen card
• Blocked card
• Fraudulent card
• Expired card
• Invalid card

Configuration Options:

• Toggle on/off: Enable or disable the automatic email notification
• Main phone number: The phone number displayed in the email for customers who prefer to call instead of using the online link