### Create Customer Bank Account - Ruby Example

Source: https://docs.payplus.co.il/reference/banks

This Ruby example demonstrates creating a customer bank account via the Payplus API. It outlines the HTTP request setup, including the endpoint, headers, and request body.

```ruby
# Ruby example for creating a customer bank account
# Requires 'net/http' and 'json' libraries

require 'net/http'
require 'uri'
require 'json'

def create_bank_account(customer_uid, bank_code, branch_code, account_number, account_name, api_key, secret_key)
  uri = URI.parse('https://restapi.payplus.co.il/api/v1.0/Banks/CreateCustomerBankAccount')
  https = Net::HTTP.new(uri.host, uri.port)
  https.use_ssl = true

  request = Net::HTTP::Post.new(uri.path)
  request['api-key'] = api_key
  request['secret-key'] = secret_key
  request['content-type'] = 'application/json'

  request.body = {
    customer_uid: customer_uid,
    bank_code: bank_code,
    branch_code: branch_code,
    account_number: account_number,
    account_name: account_name
  }.to_json

  response = https.request(request)
  return JSON.parse(response.body) if response.code == '200'
  raise "Error: #{response.code} - #{response.body}"
end

# Example usage:
# begin
#   result = create_bank_account('some_customer_uid', 1, 123, '123456789', 'John Doe', 'YOUR_API_KEY', 'YOUR_SECRET_KEY')
#   puts "Success: #{result}"
# rescue => e
#   puts "Failed: #{e.message}"
# end

```

--------------------------------

### ListGroup API Request Examples (Shell, Node, Ruby, PHP, Python)

Source: https://docs.payplus.co.il/reference/coupons

Examples of how to call the ListGroup API endpoint using various programming languages. These examples demonstrate the GET request to the base URL, including necessary headers like 'accept'. The 'skip' and 'take' query parameters can be added for pagination.

```Shell
curl --request GET \
     --url https://restapi.payplus.co.il/api/v1.0/Coupons/ListGroup \
     --header 'accept: application/json'
```

```Node.js
const https = require('https');

const options = {
  method: 'GET',
  hostname: 'restapi.payplus.co.il',
  port: null,
  path: '/api/v1.0/Coupons/ListGroup',
  headers: {
    'accept': 'application/json'
  }
};

const req = https.request(options, function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
```

```Ruby
require 'uri'
require 'net/http'

url = URI("https://restapi.payplus.co.il/api/v1.0/Coupons/ListGroup")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"

response = http.request(request)
puts response.read_body
```

```PHP
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, "https://restapi.payplus.co.il/api/v1.0/Coupons/ListGroup");
curl_setopt($curl, CURLOPT_HTTPHEADER, [
  'accept: application/json',
]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$resp = curl_exec($curl);
curl_close($curl);

var_dump($resp);
?>
```

```Python
import http.client

conn = http.client.HTTPSConnection("restapi.payplus.co.il")
payload = ""
headers = {
  "accept": "application/json"
}
conn.request("GET", "/api/v1.0/Coupons/ListGroup", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

--------------------------------

### Add Product Endpoint - Python Example

Source: https://docs.payplus.co.il/reference/products

This Python example demonstrates how to create a product via the PayPlus API. It uses the 'requests' library to send a POST request, including the API key, secret key, and product details in the JSON payload. The 'requests' library must be installed.

```python
import requests
import json

api_key = 'YOUR_API_KEY'
secret_key = 'YOUR_SECRET_KEY'
url = 'https://restapi.payplus.co.il/api/v1.0/Products/Add'

product_data = {
    "name": "Example Product",
    "price": 100,
    "currency_code": "ILS",
    "vat_type": 0
}

headers = {
    'Api-Key': api_key,
    'Secret-Key': secret_key,
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=json.dumps(product_data))

if response.status_code == 200:
    print("Product added successfully:", response.json())
else:
    print(f"Error adding product: {response.status_code} - {response.text}")
```

--------------------------------

### Add Product Endpoint - Node.js Example

Source: https://docs.payplus.co.il/reference/products

This Node.js example shows how to create a product using the 'Add' endpoint. It utilizes the 'axios' library to send a POST request with the necessary headers and product details in the request body. This snippet requires 'axios' to be installed.

```javascript
const axios = require('axios');

const apiKey = 'YOUR_API_KEY';
const secretKey = 'YOUR_SECRET_KEY';
const url = 'https://restapi.payplus.co.il/api/v1.0/Products/Add';

const productData = {
  "name": "Example Product",
  "price": 100,
  "currency_code": "ILS",
  "vat_type": 0
};

axios.post(url, productData, {
  headers: {
    'Api-Key': apiKey,
    'Secret-Key': secretKey,
    'Content-Type': 'application/json'
  }
})
.then(response => {
  console.log('Product added successfully:', response.data);
})
.catch(error => {
  console.error('Error adding product:', error.response ? error.response.data : error.message);
});
```

--------------------------------

### POST /websites/payplus_co_il_reference/add

Source: https://docs.payplus.co.il/reference/create-a-resource

This endpoint allows you to create a new customer in the system. It is used to onboard new clients to the Payplus platform.

```APIDOC
## POST /websites/payplus_co_il_reference/add

### Description
This endpoint allows you to create a new customer in the system.

### Method
POST

### Endpoint
/websites/payplus_co_il_reference/add

### Parameters
#### Request Body
- **customer_data** (object) - Required - The data for the new customer.
  - **name** (string) - Required - The name of the customer.
  - **email** (string) - Required - The email address of the customer.
  - **phone** (string) - Optional - The phone number of the customer.

### Request Example
```json
{
  "customer_data": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "123-456-7890"
  }
}
```

### Response
#### Success Response (201)
- **customer_id** (string) - The unique identifier for the newly created customer.
- **message** (string) - A confirmation message.

#### Response Example
```json
{
  "customer_id": "cust_12345abcde",
  "message": "Customer created successfully."
}
```

#### Error Response (400)
- **error** (string) - An error message describing the issue (e.g., missing required fields, invalid data).

#### Error Response Example
```json
{
  "error": "Missing required field: email"
}
```
```

--------------------------------

### Get Deposit List (Python)

Source: https://docs.payplus.co.il/reference/deposit

This snippet provides a Python example for retrieving a deposit list from the PayPlus API. It uses the 'requests' library to send a GET request with specified query parameters and headers. Ensure the 'requests' library is installed.

```python
# Example using requests for Python
import requests

api_key = 'YOUR_API_KEY'
secret_key = 'YOUR_SECRET_KEY'
base_url = 'https://restapi.payplus.co.il/api/v1.0/Deposit/list'

params = {
    'terminal_uid': '84aa6e4e-fe42-4d5f-b9cd-59dbc3817f10',
    'fromDate': '2020-01-01',
    'untilDate': '2020-12-12',
    # 'currency_code': 'ILS',
    # 'deposit_uid': '84aa6e4e-fe42-4d5f-b9cd-59dbc3817c34',
    # 'skip': '0',
    # 'take': '5'
}

headers = {
    'api-key': api_key,
    'secret-key': secret_key,
    'accept': 'application/json'
}

try:
    response = requests.get(base_url, headers=headers, params=params)
    response.raise_for_status()  # Raise an exception for bad status codes
    print(response.json())
except requests.exceptions.RequestException as e:
    print(f'Error fetching deposit list: {e}')
```

--------------------------------

### Get Deposit List (Node.js)

Source: https://docs.payplus.co.il/reference/deposit

This snippet shows how to fetch a list of deposits from the PayPlus API using Node.js. It utilizes the 'axios' library to make the GET request and includes example configurations for query parameters and headers. Ensure you have 'axios' installed.

```javascript
// Example using axios for Node.js
const axios = require('axios');

const apiKey = 'YOUR_API_KEY';
const secretKey = 'YOUR_SECRET_KEY';
const baseUrl = 'https://restapi.payplus.co.il/api/v1.0/Deposit/list';

async function getDepositList() {
  try {
    const response = await axios.get(baseUrl, {
      headers: {
        'api-key': apiKey,
        'secret-key': secretKey,
        'accept': 'application/json'
      },
      params: {
        terminal_uid: '84aa6e4e-fe42-4d5f-b9cd-59dbc3817f10',
        fromDate: '2020-01-01',
        untilDate: '2020-12-12',
        // currency_code: 'ILS',
        // deposit_uid: '84aa6e4e-fe42-4d5f-b9cd-59dbc3817c34',
        // skip: '0',
        // take: '5'
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error('Error fetching deposit list:', error);
  }
}

getDepositList();
```

--------------------------------

### Get Bank List - PHP

Source: https://docs.payplus.co.il/reference/dictionary

Example of how to retrieve a list of banks using PHP. This snippet illustrates sending a GET request to the API endpoint and parsing the JSON response.

```php
// PHP example would go here, likely using cURL or file_get_contents
```

--------------------------------

### Create Customer Request - cURL Example

Source: https://docs.payplus.co.il/reference/invoice-customers

Example of how to create a new customer using a cURL request. This demonstrates the POST method, URL, and required headers for the request.

```Shell
curl --request POST \
     --url https://restapi.payplus.co.il/api/v1.0/books/customers \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
```

--------------------------------

### Get Bank List - Ruby

Source: https://docs.payplus.co.il/reference/dictionary

Example of how to retrieve a list of banks using Ruby. This code demonstrates making a GET request to the Payplus API and handling the returned JSON data.

```ruby
# Ruby example would go here, likely using the 'net/http' or 'httparty' gem
```

--------------------------------

### Create Customer Request - Ruby Example

Source: https://docs.payplus.co.il/reference/invoice-customers

Example of how to create a new customer using Ruby. This demonstrates making an HTTP POST request with the required headers and JSON body.

```Ruby
require 'uri'
require 'net/http'

url = URI('https://restapi.payplus.co.il/api/v1.0/books/customers')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request['accept'] = 'application/json'
request['content-type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request['secret-key'] = 'YOUR_SECRET_KEY'
request.body = JSON.dump({
  name: 'Customer Name',
  vat_number: '123456789',
  country_iso: 'IL',
  city: 'Tel Aviv',
  street_name: 'Rothschild',
  street_number: 10,
  phone: '0501234567',
  email: 'customer@example.com',
  paying_vat: true
})

response = http.request(request)
puts response.read_body
```

--------------------------------

### Get Bank List - Node.js

Source: https://docs.payplus.co.il/reference/dictionary

Example of how to retrieve a list of banks using Node.js. This snippet demonstrates making a GET request to the Payplus API endpoint and handling the JSON response.

```javascript
// Node.js example would go here, likely using a library like 'axios' or 'node-fetch'
```

--------------------------------

### Add Product Endpoint - cURL Example

Source: https://docs.payplus.co.il/reference/products

This cURL example demonstrates how to use the 'Add' product endpoint to create a new product. It includes the POST request, URL, headers, and a sample JSON body specifying currency and VAT type. Ensure you replace placeholders with actual values.

```shell
curl --request POST \
     --url https://restapi.payplus.co.il/api/v1.0/Products/Add \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data \
{
  "currency_code": "ILS",
  "vat_type": 0
}
'
```

--------------------------------

### Get Bank List - Python

Source: https://docs.payplus.co.il/reference/dictionary

Example of how to retrieve a list of banks using Python. This code snippet shows how to send a GET request to the specified API endpoint and process the JSON response.

```python
# Python example would go here, likely using the 'requests' library
```

--------------------------------

### Create Customer Bank Account - Node.js Example

Source: https://docs.payplus.co.il/reference/banks

This Node.js example shows how to create a customer bank account using the Payplus API. It includes setting up the request with the necessary URL, headers, and body parameters.

```javascript
// Node.js example for creating a customer bank account
// Requires 'axios' or similar HTTP client library

const axios = require('axios');

const createBankAccount = async (customerUid, bankCode, branchCode, accountNumber, accountName, apiKey, secretKey) => {
  const url = 'https://restapi.payplus.co.il/api/v1.0/Banks/CreateCustomerBankAccount';
  const headers = {
    'api-key': apiKey,
    'secret-key': secretKey,
    'content-type': 'application/json'
  };
  const data = {
    customer_uid: customerUid,
    bank_code: bankCode,
    branch_code: branchCode,
    account_number: accountNumber,
    account_name: accountName
  };

  try {
    const response = await axios.post(url, data, { headers: headers });
    return response.data;
  } catch (error) {
    console.error('Error creating bank account:', error.response ? error.response.data : error.message);
    throw error;
  }
};

// Example usage:
// createBankAccount('some_customer_uid', 1, 123, '123456789', 'John Doe', 'YOUR_API_KEY', 'YOUR_SECRET_KEY')
//   .then(result => console.log('Success:', result))
//   .catch(err => console.error('Failed'));

```

--------------------------------

### Get Bank List - cURL

Source: https://docs.payplus.co.il/reference/dictionary

Example of how to retrieve a list of banks using a cURL request. This command utilizes the GET method to access the specified API endpoint and requests the response in JSON format.

```shell
curl --request GET \
     --url https://restapi.payplus.co.il/api/v1.0/Banks/List \
     --header 'accept: application/json'
```

--------------------------------

### Create Customer Request - Python Example

Source: https://docs.payplus.co.il/reference/invoice-customers

Example of how to create a new customer using Python. This code snippet demonstrates sending a POST request with headers and a JSON body.

```Python
import requests
import json

url = "https://restapi.payplus.co.il/api/v1.0/books/customers"

payload = {
    "name": "Customer Name",
    "vat_number": "123456789",
    "country_iso": "IL",
    "city": "Tel Aviv",
    "street_name": "Rothschild",
    "street_number": 10,
    "phone": "0501234567",
    "email": "customer@example.com",
    "paying_vat": True
}

headers = {
    'accept': 'application/json',
    'content-type': 'application/json',
    'api-key': 'YOUR_API_KEY',
    'secret-key': 'YOUR_SECRET_KEY'
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

--------------------------------

### Get Transaction History (cURL)

Source: https://docs.payplus.co.il/reference/reports-transactions

This example demonstrates how to retrieve transaction history using a cURL request. It specifies the POST method, the endpoint URL, and necessary headers like 'accept' and 'content-type'. This is a fundamental example for interacting with the API.

```shell
curl --request POST \
     --url https://restapi.payplus.co.il/api/v1.0/TransactionReports/TransactionsHistory \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
```

--------------------------------

### Create Customer Request - Node.js Example

Source: https://docs.payplus.co.il/reference/invoice-customers

Example of how to create a new customer using Node.js. This snippet shows how to make a POST request with the necessary headers and body parameters.

```Node.js
const fetch = require('node-fetch');

const options = {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'content-type': 'application/json',
    'api-key': 'YOUR_API_KEY',
    'secret-key': 'YOUR_SECRET_KEY'
  },
  body: JSON.stringify({
    name: 'Customer Name',
    vat_number: '123456789',
    country_iso: 'IL',
    city: 'Tel Aviv',
    street_name: 'Rothschild',
    street_number: 10,
    phone: '0501234567',
    email: 'customer@example.com',
    paying_vat: true
  })
};

fetch('https://restapi.payplus.co.il/api/v1.0/books/customers', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
```

--------------------------------

### POST /Customers/Add

Source: https://docs.payplus.co.il/reference/create-a-resource

This endpoint allows you to create a new customer in the system. It requires authentication via API key and secret key.

```APIDOC
## POST /Customers/Add

### Description
This endpoint allows you to create a new customer in the system.

### Method
POST

### Endpoint
https://restapi.payplus.co.il/api/v1.0/Customers/Add

### Parameters
#### Header Parameters
- **api-key** (string) - Required - API Key
- **secret-key** (string) - Required - Secret Key

#### Request Body
- **email** (string) - Required - Customer email address.
- **customer_name** (string) - Required - Customer name.
- **paying_vat** (boolean) - Optional - Lets the system know if the customer is paying VAT or not. Defaults to true.
- **vat_number** (integer) - Optional - Customer or Company VAT number.
- **customer_number** (string) - Optional - Internal customer number in the system.
- **notes** (string) - Optional - Notes, comments, or additional information about the customer.
- **phone** (string) - Optional - Customer phone number.
- **contacts** (array) - Optional - Contact details associated with the customer.
  - **full_name** (string) - Contact's full name.
  - **cell_phone** (string) - Contact's cell phone number.
  - **contact_email** (string) - Contact's email address.
  - **contact_address** (string) - Contact's address.
  - **contact_city** (string) - Contact's city.
  - **contact_postal_code** (string) - Contact's postal code.
  - **contact_country_iso** (string) - Contact's country code (e.g., "IL").
  - **job_position** (string) - Enum: ["main-contact-person", "management", "technical-department", "accounting-and-finance", "legal-department", "personnel-department", "marketing-and-advertising-department", "other"]
- **business_address** (object) - Optional - Business address details.

### Request Example
```json
{
  "email": "customer@example.com",
  "customer_name": "John Doe",
  "paying_vat": true,
  "vat_number": 123456789,
  "customer_number": "CUST1001",
  "notes": "Preferred contact method is email.",
  "phone": "+1234567890",
  "contacts": [
    {
      "full_name": "Jane Smith",
      "cell_phone": "+1987654321",
      "contact_email": "jane.smith@example.com",
      "contact_address": "123 Main St",
      "contact_city": "Anytown",
      "contact_postal_code": "12345",
      "contact_country_iso": "US",
      "job_position": "main-contact-person"
    }
  ],
  "business_address": {
    "street": "456 Business Ave",
    "city": "Businesstown",
    "postal_code": "67890",
    "country_iso": "US"
  }
}
```

### Response
#### Success Response (200)
- **customer_id** (string) - The unique identifier for the newly created customer.
- **message** (string) - A success message indicating the customer was added.

#### Response Example
```json
{
  "customer_id": "cust_abcdef123456",
  "message": "Customer added successfully."
}
```

#### Error Response
- **error_code** (integer) - The error code.
- **error_message** (string) - A description of the error.

#### Error Response Example
```json
{
  "error_code": 400,
  "error_message": "Invalid input parameters."
}
```
```

--------------------------------

### Get Expense Record Data - OpenAPI Specification

Source: https://docs.payplus.co.il/reference/get_books-expenses-uuid

This snippet defines the GET endpoint for retrieving expense record data. It specifies the path parameters, header parameters (API key and secret key), and the structure of the 200 OK response, including an example of the returned JSON object.

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "PayPlus - API Documentation - Production",
    "version": "1.0"
  },
  "tags": [
    {
      "name": "Invoice+ - Expenses"
    }
  ],
  "servers": [
    {
      "url": "https://restapi.payplus.co.il/api/v1.0/",
      "description": "Production"
    },
    {
      "url": "https://restapidev.payplus.co.il/api/v1.0/",
      "description": "Staging"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/books/expenses/{uuid}": {
      "get": {
        "tags": [
          "Invoice+ - Expenses"
        ],
        "summary": "Get expense record data",
        "description": "",
        "parameters": [
          {
            "name": "uuid",
            "in": "path",
            "description": "Requested document uuid Example: a5f514de-c8c8-262a-ac31-31d609f3550a.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "api-key",
            "in": "header',
            "description": "API Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "secret-key",
            "in": "header",
            "description": "Secret Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n\"barcode\": \"472819632332439\",\n\"brand\": {\n\"name\": \"Company Name\",\n\"uuid\": \"67a8cc93-75ac-4832-8386-3eb5b24bf3d0\"\n},\n\"copyDocAddress\": \"https://restapi.payplus.co.il/getdoc/s/c/1fa79282-61d1-4898-b7b9-afa67f46d34a.pdf\",\n\"currency_code\": \"ILS\",\n\"customer\": {\n\"customer_name\": \"John Doe\",\n\"email\": \"johndoe@example.com\",\n\"phone\": \"123456789\",\n\"subject_code\": \"987654321\",\n\"uuid\": \"faa6280f-dba5-4889-9b15-de60e1527bdc\",\n\"vat_number\": \"1231231\"\n},\n\"customer_uuid\": \"faa6280f-dba5-4889-9b15-de60e1527bdc\",\n\"docUID\": \"1fa79282-61d1-4898-b7b9-afa67f46d34a\",\n\"doc_date\": \"2022-11-15\",\n\"doc_type\": \"inv_tax\",\n\"more_info\": null,\n\"number\": \"SCP/50042\",\n\"originalDocAddress\": \"https://restapi.payplus.co.il/getdoc/s/o/1fa79282-61d1-4898-b7b9-afa67f46d34a.pdf\",\n\"total_items_base_currency\": 150,\n\"validDocumentGenerated\": true\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "barcode": {
                      "type": "string",
                      "example": "472819632332439"
                    },
                    "brand": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Company Name"
                        },
                        "uuid": {
                          "type": "string",
                          "example": "67a8cc93-75ac-4832-8386-3eb5b24bf3d0"
                        }
                      }
                    },
                    "copyDocAddress": {
                      "type": "string",
                      "example": "https://restapi.payplus.co.il/getdoc/s/c/1fa79282-61d1-4898-b7b9-afa67f46d34a.pdf"
                    },
                    "currency_code": {
                      "type": "string",
                      "example": "ILS"
                    },
                    "customer": {
                      "type": "object",
                      "properties": {
                        "customer_name": {
                          "type": "string",
                          "example": "John Doe"
                        },
                        "email": {
                          "type": "string",
                          "example": "johndoe@example.com"
                        },
                        "phone": {
                          "type": "string",
                          "example": "123456789"
                        },
                        "subject_code": {
                          "type": "string",
                          "example": "987654321"
                        },
                        "uuid": {
                          "type": "string",
                          "example": "faa6280f-dba5-4889-9b15-de60e1527bdc"
                        },
                        "vat_number": {
                          "type": "string",
                          "example": "1231231"
                        }
                      }
                    },
                    "customer_uuid": {
                      "type": "string",
                      "example": "faa6280f-dba5-4889-9b15-de60e1527bdc"
                    },
                    "docUID": {
                      "type": "string",
                      "example": "1fa79282-61d1-4898-b7b9-afa67f46d34a"
                    },
                    "doc_date": {
                      "type": "string",
                      "example": "2022-11-15"
                    },
                    "doc_type": {
                      "type": "string",
                      "example": "inv_tax"
                    },
                    "more_info": {
                      "type": null
                    },
                    "number": {
                      "type": "string",
                      "example": "SCP/50042"
                    },
                    "originalDocAddress": {
                      "type": "string",
                      "example": "https://restapi.payplus.co.il/getdoc/s/o/1fa79282-61d1-4898-b7b9-afa67f46d34a.pdf"
                    },
                    "total_items_base_currency": {
                      "type": "number",
                      "example": 150
                    },
                    "validDocumentGenerated": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Create Customer Request - PHP Example

Source: https://docs.payplus.co.il/reference/invoice-customers

Example of how to create a new customer using PHP. This snippet shows how to send a POST request with appropriate headers and JSON payload.

```PHP
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, 'https://restapi.payplus.co.il/api/v1.0/books/customers');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
  'accept: application/json',
  'content-type: application/json',
  'api-key: YOUR_API_KEY',
  'secret-key: YOUR_SECRET_KEY'
]);

$data = [
    'name' => 'Customer Name',
    'vat_number' => '123456789',
    'country_iso' => 'IL',
    'city' => 'Tel Aviv',
    'street_name' => 'Rothschild',
    'street_number' => 10,
    'phone' => '0501234567',
    'email' => 'customer@example.com',
    'paying_vat' => true
];

curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
}

curl_close($curl);

echo $response;
?>

```

--------------------------------

### Get Deposit List (cURL)

Source: https://docs.payplus.co.il/reference/deposit

This snippet demonstrates how to make a GET request to the PayPlus API to retrieve a list of deposits. It requires an API key and secret key, and accepts various query parameters for filtering and pagination. The base URL is specified, along with example headers.

```shell
curl --request GET \
     --url https://restapi.payplus.co.il/api/v1.0/Deposit/list \
     --header 'accept: application/json'
```

--------------------------------

### Create Customer Bank Account - PHP Example

Source: https://docs.payplus.co.il/reference/banks

This PHP example illustrates how to use the Payplus API to create a customer bank account. It covers setting up the cURL request with the correct URL, headers, and JSON payload.

```php
<?php

function createBankAccount($customerUid, $bankCode, $branchCode, $accountNumber, $accountName, $apiKey, $secretKey) {
    $url = 'https://restapi.payplus.co.il/api/v1.0/Banks/CreateCustomerBankAccount';
    
    $headers = [
        'api-key: ' . $apiKey,
        'secret-key: ' . $secretKey,
        'content-type: application/json'
    ];
    
    $data = json_encode([
        'customer_uid' => $customerUid,
        'bank_code' => $bankCode,
        'branch_code' => $branchCode,
        'account_number' => $accountNumber,
        'account_name' => $accountName
    ]);

    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if (curl_errno($ch)) {
        $error_msg = curl_error($ch);
        curl_close($ch);
        throw new Exception('cURL Error: ' . $error_msg);
    }
    
    curl_close($ch);

    if ($httpCode >= 200 && $httpCode < 300) {
        return json_decode($response, true);
    } else {
        throw new Exception('API Error: HTTP Code ' . $httpCode . ' - Response: ' . $response);
    }
}

// Example usage:
// try {
//     $result = createBankAccount('some_customer_uid', 1, 123, '123456789', 'John Doe', 'YOUR_API_KEY', 'YOUR_SECRET_KEY');
//     print_r($result);
// } catch (Exception $e) {
//     echo 'Error: ' . $e->getMessage();
// }

?>

```

--------------------------------

### Create Customer Bank Account - Python Example

Source: https://docs.payplus.co.il/reference/banks

This Python example shows how to create a customer bank account using the Payplus API. It utilizes the `requests` library to send a POST request with appropriate headers and JSON data.

```python
# Python example for creating a customer bank account
# Requires 'requests' library

import requests
import json

def create_bank_account(customer_uid, bank_code, branch_code, account_number, account_name, api_key, secret_key):
    url = 'https://restapi.payplus.co.il/api/v1.0/Banks/CreateCustomerBankAccount'
    headers = {
        'api-key': api_key,
        'secret-key': secret_key,
        'content-type': 'application/json'
    }
    data = {
        'customer_uid': customer_uid,
        'bank_code': bank_code,
        'branch_code': branch_code,
        'account_number': account_number,
        'account_name': account_name
    }

    try:
        response = requests.post(url, headers=headers, json=data)
        response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error creating bank account: {e}")
        # You might want to inspect response.text for more details if available
        if hasattr(e, 'response') and e.response is not None:
            print(f"Response: {e.response.text}")
        raise

# Example usage:
# try:
#     result = create_bank_account('some_customer_uid', 1, 123, '123456789', 'John Doe', 'YOUR_API_KEY', 'YOUR_SECRET_KEY')
#     print(f"Success: {result}")
# except Exception as e:
#     print(f"Failed: {e}")

```