Iframe/Redirect – Programmer Manual

				
					{
  "terminal": "1234567",
  "user": "John Doe",
  "password": "132456789",
  "Transactionld": "1a5b1c-1d1f6g-9h8j"
}
				
			

				
					 {
"ConfirmationKey": "1a5b1c-1d1f6g-9h8j ",
 "UniqueKey": "123456789", 
"TotalX100": "100", 
 }
				
			

				
					{
  "terminal": "0882577012",
  "user": "xxxxx",
  "password": "xxXXX",
  "GoodURL": "[https://gateway21.pelecard.biz/sandbox/landingpage](https://gateway21.pelecard.biz/sandbox/landingpage)",
  "ErrorURL": "[https://gateway21.pelecard.biz/sandbox/landingpage](https://gateway21.pelecard.biz/sandbox/landingpage)",
  "ActionType": "J4",
  "Currency": "1",
  "Total": "100",
  "CreateToken": "True",
  "Language": "HE",
  "CustomerldField": "must",
  "Cvv2Field": "must",
  "MaxPayments": "12",
  "MinPayments": "1",
  "MinPayments ForCredit": "7",
  "FirstPayment": "auto",
  "ShopNo": "001",
  "ParamX": "test payment",
  "CssURL": "[https://gateway21.pelecard.biz/Content/Css/variant-he-3.css](https://gateway21.pelecard.biz/Content/Css/variant-he-3.css)",
  "LogoURL": "[https://gateway21.pelecard.biz/Content/images/Pelecard.png](https://gateway21.pelecard.biz/Content/images/Pelecard.png)"
}

				
			

				
					{
  "StatusCode": "000",
  "ErrorMessage": "operation success",
  "ResultData": {
    "TransactionId": "111e4629-a057-41f4-858b-550650ba9404",
    "ShvaResult": "000",
    "Additional DetailsParamX": "test payment",
    "Token": "",
    "DebitApproveNumber": "0000000",
    "ConfirmationKey": "cfa825d17b15efbd25ce71279eedf111",
    "VoucherId": "11-111-111",
    "Transaction PelecardId": 11111,
    "CardHolderID": "123456789",
    "CardHolderName": "",
    "CardHolder Email": "",
    "CardHolderPhone": "",
    "ShvaFileNumber": 11,
    "StationNumber": 1,
    "Reciept": 11,
    "JParam": 4,
    "CreditCardNumber": "11******1111",
    "CreditCardExpDate": "0118",
    "CreditCardCompanyClearer": 2,
    "CreditCardCompanylssuer": 2,
    "CreditCardStarsDiscountTotal": 0,
    "CreditType": 1,
    "CreditCardAbroadCard": 1,
    "DebitType": 1,
    "DebitCode": 50,
    "DebitTotal": 100,
    "DebitCurrency": "1",
    "TotalPayments": 0,
    "FirstPayment Total": 0,
    "Fixed Payment Total": 0,
    "shvaOutput": "0000000000045******458022000212140000000100 0000000000000000000000000084001016  \u0086%%...1 \\r\\n,",
    "CardHebName": "ישראכרט",
    "CreditCardBrand": "2",
    "ApprovedBy": "0",
    "CallReason": "3",
    "TransactionInitTime": "01/01/2015 11:11:11",
    "Transaction Update Time": "01/01/2015 11:11:11"
  }
}

				
			

				
					“GooglePay”:{
 "CardHolderName": "hide/must/optional/[input_value]",
 "CustomerIdField": "hide/must/optional/[input_value]",
 "CustomerAddressField": "True/False/[input_value]",
 "CustomerCityField": "True/False/[input_value]",
 "CustomerIndexField": "True/False/[input_value]",
 "CustomerCountryField": "True/False/[input_value]",
 "BusinessNumber": "True/False/[input_value]",
 "Cvv2Field": "hide/must/optional",
 "EmailField": "hide/must/optional/[input_value]",
 "Remarks": "hide/must/optional/[input_value]",
 "TelField": "hide/must/optional/[input_value]",
"ReadOnlyFields": {
  "CardHolderName": "True/False",
  "CustomerAddressField": "True/False",
  "CustomerCityField": "True/False",
  "CustomerIdField": "True/False",
  "CustomerIndexField": "True/False",
  "CustomerCountryField": "True/False",
  "BusinessNumber": "True/False ",
  "EmailField": "True/False",
  "TelField": "True/False"
 }
}

				
			

				
					{
  "terminal": "0882577012",
  "user": "xxxxx",
  "password": "xXXXXXXXXX",
  "ActionType": "J4",
  "Currency": "1",
  "Total": "100",
  "GoodURL": "[https://gateway21.pelecard.biz/sandbox/landingpage](https://gateway21.pelecard.biz/sandbox/landingpage)",
  "PayperParameters": {
    "typeDocument": "Invoice-Receipt",
    "DataPayper": {
      "document_lang": "he",
      "customer_unique_id": "123456789",
      "customer_mail": "op@pelecard.co.il",
      "customer_name": "pelecard",
      "customer_mobile": "0544444444",
      "customer_business_phone": "036579500",
      "customer_address": "דרך עדן 9 ראשון לציון",
      "document_subject": "נושא המסמך",
      "document_remarks": "הערות למסמך",
      "send_by_mail": "true",
      "document_rounded": "false",
      "document_no_vat": "false",
      "income_id": "335",
      "invoice_lines": [
        {
          "description": "מוצר 1",
          "quantity": "1",
          "price_per_unit": "100",
          "include_vat": "true",
          "No_vat": "false",
          "catalog_id": "1111"
        }
      ]
    }
  }
}

				
			

				
					"Paypal" : { 
" User": "serg_stern-facilitator_api1.yahoo.com," 
" PassWord": "1381907892," 
" Signature": "AGFylK6s59NBDWEheDiE6fMmb3sYAq9jXHFJ14ofB6dO8gGtw09DpWLF," " INVNUM": "a716976f9cc70757adec7329b00c9ae1,"  
" RETURNURL": "https://gateway.pelecard.biz/post/landingpage.aspx," 
" VALIDATELINK": "http://pelecard.tool.co.il/res.php," 
" CANCELURL": "http://pelecard.com," 
" HDRIMG": "https://gateway.pelecard.biz/Content/images/PpBigLogo.jpg," 
" LOGOIMG": "https://gateway.pelecard.biz/Content/images/PpSmallLogo.jpg," 
" BRANDNAME,"שם העסק" :" 
" ENVIRONMENT": "0," 
" PAYMENTACTION": "sale," 
" CUSTOMERSERVICENUMBER": "036579500," 
" AMT": "100," 
" CURRENCYCODE": "ILS," 
" LOCALECODE": "he_IL," 
" DESC": "bla bla," 
" PaypalText,"הדרך המהירה והבטוחה יותר לשלם באינטרנט מבלי לחשוף את פרטי כרטיס האשראי" :" " PaypalBtnText שלם באמצעות" :"Pay-Pal" 
 
				
			

				
					 $userName,
    'password' => $password,
    'terminal' => $termNo,
    'GoodURL' => $goodUrl,
    'Total' => $totalAmount,
    'Currency' => $currencyCode,
    // Add other parameters like 'ErrorURL', 'ActionType', 'ParamX', etc.
    // 'ErrorURL' => 'your_error_url',
    // 'ActionType' => 'J4',
    // 'ParamX' => 'Order 123',
);

$jsonData = json_encode($data);
$ch = curl_init('https://gateway21.pelecard.biz/PaymentGW/init');

curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json; charset=UTF-8', // Ensure correct Content-Type
    'Content-Length: ' . strlen($jsonData)
));
// Optional: Add timeout settings
// curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
// curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$result = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curl_error = curl_error($ch);

curl_close($ch);

if ($curl_error) {
    echo "cURL Error: " . $curl_error;
    // Handle cURL error (e.g., log, display generic error)
} elseif ($httpcode >= 200 && $httpcode < 300) {
    // Decode the JSON response
    $serverData = json_decode($result, true);

    // Check if decoding was successful and if the 'URL' key exists and status is '000'
    if (json_last_error() === JSON_ERROR_NONE && isset($serverData['URL']) && isset($serverData['StatusCode']) && $serverData['StatusCode'] == '000') {
        echo "Received URL: " . $serverData['URL'];
        // Use the URL: redirect user or set iframe src
        // header('Location: ' . $serverData['URL']); // Example redirect
        // exit;
    } elseif (isset($serverData['ErrorMessage'])) {
        // Handle specific error message from Pelecard
        echo "Server Error: " . $serverData['ErrorMessage'] . " (Status Code: " . (isset($serverData['StatusCode']) ? $serverData['StatusCode'] : 'N/A') . ")";
        // Log the full response for debugging
        // error_log("Pelecard Error Response: " . $result);
    } else {
        // Handle unexpected response format or missing URL/StatusCode
        echo "Error decoding JSON or required keys missing in response.";
        echo &quot;Raw Server Response: <pre>" . htmlspecialchars($result) . "</pre>";
        // Log the full response for debugging
        // error_log("Pelecard Unexpected Response: " . $result);
    }
} else {
    // Handle HTTP errors (4xx, 5xx)
    echo "HTTP Error: " . $httpcode;
    echo "Raw Server Response: <pre>" . htmlspecialchars($result) . "</pre>";
    // Log the full response for debugging
    // error_log("Pelecard HTTP Error " . $httpcode . ": " . $result);
}

?&gt;

				
			

				
					using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Json;
using System.Text;
using System.Diagnostics; // For Debug.WriteLine
// Consider using System.Net.Http and System.Text.Json for modern .NET
// using System.Net.Http;
// using System.Text.Json;

namespace nameSpaceName // Replace with your actual namespace
{
    // Define a class to hold the JSON request parameters
    // Use DataContract/DataMember for serialization control with DataContractJsonSerializer
    [DataContract]
    public class JsonTransactionDetails
    {
        // Required fields
        [DataMember] public string terminal { get; set; }
        [DataMember] public string user { get; set; }
        [DataMember] public string password { get; set; }
        [DataMember] public string GoodURL { get; set; }
        [DataMember] public string Total { get; set; } // Send as string representing agorot
        [DataMember] public string Currency { get; set; } // e.g., "1" for ILS

        // Optional fields (Add [DataMember(EmitDefaultValue = false)] if you only want to send them when they have non-default values)
        [DataMember(EmitDefaultValue = false)] public string ErrorURL { get; set; }
        [DataMember(EmitDefaultValue = false)] public string CancelURL { get; set; }
        [DataMember(EmitDefaultValue = false)] public string ActionType { get; set; } // e.g., "J4"
        [DataMember(EmitDefaultValue = false)] public string CreateToken { get; set; } // "True" or "False" as string
        [DataMember(EmitDefaultValue = false)] public string Language { get; set; } // "HE", "EN", "RU"
        [DataMember(EmitDefaultValue = false)] public string CustomerIdField { get; set; } // "must", "optional", "value", "hide" etc.
        [DataMember(EmitDefaultValue = false)] public string Cvv2Field { get; set; } // "must", "optional", "hide"
        [DataMember(EmitDefaultValue = false)] public string MaxPayments { get; set; }
        [DataMember(EmitDefaultValue = false)] public string MinPayments { get; set; }
        [DataMember(EmitDefaultValue = false)] public string ShopNo { get; set; }
        [DataMember(EmitDefaultValue = false)] public string ParamX { get; set; }
        [DataMember(EmitDefaultValue = false)] public string UserKey { get; set; }
        [DataMember(EmitDefaultValue = false)] public string CssURL { get; set; }
        [DataMember(EmitDefaultValue = false)] public string LogoURL { get; set; }
        // Add other optional fields as needed based on documentation...
    }

    // Define classes to hold the expected JSON response structure
    [DataContract]
    public class JsonTransactionResponse
    {
        [DataMember] public string StatusCode { get; set; }
        [DataMember] public string ErrorMessage { get; set; }
        [DataMember] public string URL { get; set; } // The URL for iframe/redirect
        // ResultData is usually empty/null in the Init response, but included for completeness if needed
        [DataMember(EmitDefaultValue = false)] public ResultDataStructure ResultData { get; set; }
    }

    [DataContract]
    public class ResultDataStructure // Define based on GetTransaction/Feedback response if needed later
    {
        [DataMember] public string TransactionId { get; set; }
        // Add other fields from ResultData if expected...
    }


    public partial class Pay : System.Web.UI.Page // Assuming Web Forms
    {
        protected void SubmitJsonData(object sender, EventArgs e)
        {
            // Fill in the JSON parameters
            var jsonTransactionRequest = new JsonTransactionDetails()
            {
                // --- Required Fields ---
                terminal = "your_terminal_number", // Replace with actual value
                user = "your_username",         // Replace with actual value
                password = "your_password",       // Replace with actual value
                GoodURL = "https://yourdomain.com/success", // Replace with your actual success URL
                Total = "100", // Example: 1 NIS = 100 agorot. Replace with actual amount.
                Currency = "1", // "1" for ILS (NIS)

                // --- Optional Fields (Examples) ---
                ErrorURL = "https://yourdomain.com/error", // Replace with your actual error URL
                ActionType = "J4", // Default debit action
                ParamX = "My Order 123",
                CreateToken = "False", // Set to "True" if you need a token
                Language = "EN", // Example: English
                // Add and assign other optional properties as needed
            };

            // Create JSON object and encode using DataContractJsonSerializer
            var jsonRequestSerializer = new DataContractJsonSerializer(typeof(JsonTransactionDetails));
            MemoryStream jsonMemoryStream = new MemoryStream();
            jsonRequestSerializer.WriteObject(jsonMemoryStream, jsonTransactionRequest);
            byte[] jsonRequestBytes = jsonMemoryStream.ToArray();
            string requestJsonString = Encoding.UTF8.GetString(jsonRequestBytes); // For logging
            Debug.WriteLine("Request JSON: " + requestJsonString);


            // Create request using HttpWebRequest (older method)
            var jsonWebRequest = (HttpWebRequest)WebRequest.Create("https://gateway21.pelecard.biz/PaymentGW/Init");
            jsonWebRequest.ContentType = "application/json; charset=utf-8"; // Set correct Content-Type for JSON
            jsonWebRequest.ContentLength = jsonRequestBytes.Length;
            jsonWebRequest.Method = "POST";
            // Optional: Set timeouts
            // jsonWebRequest.Timeout = 30000; // 30 seconds
            // jsonWebRequest.ReadWriteTimeout = 30000; // 30 seconds

            // Send data
            try
            {
                // Write the JSON bytes to the request stream
                using (var jsonRequestStream = jsonWebRequest.GetRequestStream())
                {
                    jsonRequestStream.Write(jsonRequestBytes, 0, jsonRequestBytes.Length);
                }

                // Read response
                using (var jsonResponse = (HttpWebResponse)jsonWebRequest.GetResponse()) // Cast to HttpWebResponse
                {
                    using (var jsonResponseStream = jsonResponse.GetResponseStream())
                    {
                        if (jsonResponseStream != null)
                        {
                            // Use DataContractJsonSerializer to deserialize the response stream directly
                            var jsonResponseSerializer = new DataContractJsonSerializer(typeof(JsonTransactionResponse));
                            var jsonTransactionResponse = (JsonTransactionResponse)jsonResponseSerializer.ReadObject(jsonResponseStream);

                            // Check the response status and use the URL
                            if (jsonTransactionResponse != null && jsonTransactionResponse.StatusCode == "000" && !string.IsNullOrEmpty(jsonTransactionResponse.URL))
                            {
                                // Success! Use the URL for iframe src or redirect
                                Debug.WriteLine("Payment URL: " + jsonTransactionResponse.URL);
                                // Example: Redirect the user
                                // Response.Redirect(jsonTransactionResponse.URL, false);
                                // Context.ApplicationInstance.CompleteRequest();

                                // Or set Iframe source (if 'paymentIframe' is your iframe control ID)
                                // paymentIframe.Attributes["src"] = jsonTransactionResponse.URL;
                            }
                            else
                            {
                                // Handle error response from Pelecard
                                string errorMessage = (jsonTransactionResponse != null) ? jsonTransactionResponse.ErrorMessage : "Invalid response structure.";
                                string statusCode = (jsonTransactionResponse != null) ? jsonTransactionResponse.StatusCode : "N/A";
                                Debug.WriteLine($"Pelecard Error: {errorMessage} (Status Code: {statusCode})");
                                // Display error to user
                                // ErrorLabel.Text = $"Error processing payment: {errorMessage}";
                            }
                        }
                        else
                        {
                             Debug.WriteLine("Error: Response stream was null.");
                             // ErrorLabel.Text = "Error receiving response from payment gateway.";
                        }
                    }
                }
            }
            catch (WebException webEx)
            {
                // Handle network errors or non-2xx HTTP responses
                string errorDetails = "Network or HTTP error.";
                if (webEx.Response != null)
                {
                    using (var errorResponse = (HttpWebResponse)webEx.Response) // Cast to HttpWebResponse
                    {
                        using (var responseStream = errorResponse.GetResponseStream())
                        {
                            if (responseStream != null)
                            {
                                using (var reader = new StreamReader(responseStream))
                                {
                                    errorDetails = reader.ReadToEnd(); // Read the error response body
                                }
                            }
                        }
                         Debug.WriteLine($"WebException: {webEx.Message} Status: {webEx.Status} HTTP Status: {errorResponse.StatusCode} Details: {errorDetails}");
                    }
                } else {
                     Debug.WriteLine($"WebException: {webEx.Message} Status: {webEx.Status} (No response received)");
                }

                // Inform user or log
                // ErrorLabel.Text = "Could not connect to payment gateway. Please try again later.";
            }
            catch (SerializationException serEx)
            {
                // Handle errors during JSON deserialization
                Debug.WriteLine("Serialization Exception: " + serEx.Message);
                // ErrorLabel.Text = "Error reading response from payment gateway.";
            }
            catch (Exception ex)
            {
                 // Handle other potential exceptions
                 Debug.WriteLine("General Exception: " + ex.ToString());
                 // Log error, inform user
                 // ErrorLabel.Text = "An unexpected error occurred. Please contact support.";
            }
        }
    }
}

				
			

				
					"ApplePay": {
  "Enabled": "true",
  "Label": "test transaction"
}

				
			

				
					{
  "terminal": "xxxxxx",
  "user": "xxxxx",
  "password": "xxxxxxx",
  "ActionType": "J4",
  "Currency": "1",
  "Total": "100",
  "GoodURL": "https://gateway21.pelecard.biz/sandbox/landingpage",
  "ApplePay": {
    "Enabled": "true",
    "Label": "test"
  }
}

				
			

				
					{
  "terminal": "xxxxx",
  "user": "xxxxxx",
  "password": "xxxxxxxx",
  "ActionType": "J4",
  "Currency": "1",
  "Total": "100",
  "GoodURL": "https://gateway21.pelecard.biz/sandbox/landingpage",
  "GooglePay": {
    "Enable": "true",
    "MerchantName": "business name"
  }
}