### Install Solidgate SDK for Go

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Installs the Solidgate SDK for Go using the go get command. This allows developers to integrate Solidgate's payment functionalities into their Go applications.

```go
go get github.com/solidgate-tech/go-sdk
```

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

### SDK Integration

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Instructions and code examples for installing and initializing the Solidgate SDK in various programming languages (PHP, Node.js, Go, Kotlin, Python).

```APIDOC
## SDK Integration

### Description
This section provides guidance on integrating the Solidgate SDK into your project. It covers installation steps for different languages and how to initialize the SDK with your API credentials.

### Step 1. Install SDK

#### PHP
```bash
composer require solidgate/php-sdk
```

#### Node.js
```bash
npm install @solidgate/node-sdk
```

#### Go
```bash
go get github.com/solidgate-tech/go-sdk
```

#### Python
```bash
pip3 install solidgate-card-sdk
```

### Step 2. Create SDK Instance

#### PHP
```php
<?php

use SolidGate\API\Api;

$api = new Api('public_key', 'secret_key');
```

#### Node.js
```javascript
const solidGate = require('@solidgate/node-sdk');

let api = new solidGate.Api("public_key", "private_key");
```

#### Go
```go
solidgateSdk := solidgate.NewSolidGateApi("public_key", "secret_key")
```

#### Kotlin
```kotlin
val api = Api(HttpClient(), Credentials("public_key", "secret_key"))
```

#### Python
```python
from solidgate import ApiClient

client = ApiClient("public_key", "secret_key")
```
```

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

### Install Solidgate SDK for PHP

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Installs the Solidgate SDK for PHP using Composer. This is the first step to integrate Solidgate's payment processing capabilities into your PHP application.

```php
composer require solidgate/php-sdk
```

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

### Install Solidgate SDK for Node.js

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Installs the Solidgate SDK for Node.js using npm. This package enables server-side integration with the Solidgate payment gateway.

```bash
npm install @solidgate/node-sdk
```

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

### Install Solidgate SDK for Python

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Installs the Solidgate card SDK for Python using pip. This library facilitates the integration of Solidgate's payment processing services into Python applications.

```python
pip3 install solidgate-card-sdk
```

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

### Initialize and Customize PayPal Button (JavaScript)

Source: https://docs.solidgate.com/payments/integrate/payment-form/apm-buttons

This example shows how to initialize the payment form with the PayPal button enabled. It includes basic PayPal button customization options such as color, shape, label, and height. Ensure that PayPal is configured for your channel and that only one PayPal button is active per `order_id`.

```javascript
const data = {
  merchantData: {
    merchant: "<-your data->",
    signature: "<-your data->",
    paymentIntent: "<-your data->",
  },
  paypalButtonParams: {
    enabled: true,
    color: "blue",
    shape: "rect",
    label: "checkout",
    height: 52
  }
};

let form = PaymentFormSdk.init(data);
```

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

### Install Solidgate Module for Magento 2

Source: https://docs.solidgate.com/payments/integrate/ecommerce-platforms/magento

Commands to copy, enable, compile, and verify the installation of the Solidgate Payment Module in a Magento 2 environment.

```bash
cp -r Solidgate /path/to/magento/app/code/
php bin/magento cache:clean
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush
php bin/magento module:status Solidgate_Payment/
```

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

### Customize Bizum Button Container

Source: https://docs.solidgate.com/payments/integrate/payment-form/apm-buttons

This example illustrates how to customize the position of the Bizum button by specifying a `div` element using its ID in the `containerId` parameter of `bizumButtonParams`. If no `containerId` is provided, the button appears above the form fields.

```javascript
<div id="yourCustomContainerId"></div>
<script>
    PaymentFormSdk.init({
        ...restData,
        bizumButtonParams: {
            enabled: true,
            containerId: 'yourCustomContainerId'
        }
    });
</script>
```

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

### Create Solidgate API Instance in Go

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Initializes the Solidgate API client in Go, passing your public and secret keys. This client is necessary for performing operations through the Solidgate API.

```go
solidgateSdk := solidgate.NewSolidGateApi("public_key", "secret_key")

```

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

### Form Initialization and Configuration

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

This section details how to initialize the Solidgate Payment Form with various configuration options and styling.

```APIDOC
## Form Initialization and Configuration

### Description
This section details how to initialize the Solidgate Payment Form with various configuration options and styling.

### Parameters
#### Query Parameters
- **containerId** (string) - Optional - Custom `containerId` to place the form. If not set, it is displayed in the element with id `solid-payment-form-container`.

### Request Body Example
```json
{
  "merchantData": {
    "merchant": "api_pk_7b197...ba108f842",
    "signature": "MjliMzU4ODE3ZDVlM2E1YWZmYzI1NmU4MzU3YjhlODRkMTJmZTk1NjIxOWNiYzFmNDk0N2NkNjk5YTA5Y2Q4NzIzOWIwMTgxZTQwOGExZjFmYWQ1NzQyYjc3ZGRjMzE0MTczYTQ2OGEyMTlmNGI4YzA5ZmNhMTczZDI0ZDBkZmM=",
    "paymentIntent": "E5FKjxw5vRjjIZBKtH_Q9oN1Wmn5icMn720prO4nPB3cYpzC9wLAHwq9IwstmD-YFLFPsdq2Rk9YzRJhxdPEq2KI19fFt1QotX-smH5_xWxGfYcvrf2Y4v4KWgbjzJylHTDM6eCXVvbdZyVU54vD3sxntN3gFiyuhEzMn8mKoDV0UdIqLN_VsTAdehBUrqk7aPNzXCfSqpy9pCBlpdFNCfgOyHoDXGGS_Z9fK3gCw7usF2v0IU96mQGzdtyEUs1Z2MJYwle7sjEkWNEb9SkpW1zUXEZCFMF8Cu-dn6fWe4cVE2Ok1MDeTE43dySgw9e8GzMxgPmG2YFjg5xcvuedQ=="
  },
  "formParams": {
    "buttonType": "default",
    "submitButtonText": "Pay",
    "isCardHolderVisible": true,
    "hideCvvNumbers": true,
    "headerText": "Enter your debit or credit card details (from merchant)",
    "titleText": "Card info (from merchant)",
    "formTypeClass": "default",
    "googleFontLink": "//fonts.googleapis.com/css2?family=DM+Sans:ital@1&display=swap",
    "autoFocus": false
  },
  "styles": {
    "submit_button": {
      "background-color": "red",
      "font-size": "16px",
      "font-weight": "bold",
      "": {
        "background-color": "green"
      },
      "form_body": {
        "font-family": "DM Sans"
      }
    }
  }
}
```
```

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

### Handling Verify Event in Angular

Source: https://docs.solidgate.com/payments/integrate/payment-form/form-events

Provides an example of integrating the Solidgate Angular SDK to respond to the 'verify' event. The `(verify)` output event binding on the `ngx-solid-payment` component triggers the `onVerify` method for custom event handling. Requires component setup and import of SDK types.

```typescript
import {Component} from '@angular/core';

import {InitConfig, SdkMessage, MessageType} from "@solidgate/angular-sdk";

@Component({
  selector: 'app-root',
  template: '
    <ngx-solid-payment
      [merchantData]="merchantData"
      (verify)="onVerify($event)"
    ></ngx-solid-payment>
  '
})
export class AppComponent {
  merchantData: InitConfig['merchantData'] = {
    merchant: '<<--YOUR MERCHANT ID-->>',
    signature: '<<--YOUR SIGNATURE OF THE REQUEST-->>',
    paymentIntent: '<<--YOUR PAYMENT INTENT-->>'
  }

  onVerify(event: SdkMessage[MessageType.Verify]): void {
    // here your logic
  }
}
```

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

### Create Solidgate API Instance in Kotlin

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Sets up the Solidgate API client in Kotlin using an HttpClient and Credentials object containing your public and secret keys. This client handles API interactions.

```kotlin
val api = Api(HttpClient(), Credentials("public_key", "secret_key"))

```

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

### Free Trial with Auth-Void Process

Source: https://docs.solidgate.com/billing/subscription-overview

Implement free trials using the auth-void process. This involves a temporary $1 authorization followed by an immediate void, verifying the payment method.

```APIDOC
## POST /api/payments/auth_void

### Description
Executes the auth-void process for free trials. A temporary $1 authorization is made and then voided. Applicable for specific payment APIs.

### Method
POST

### Endpoint
/api/payments/auth_void

### Parameters
#### Request Body
- **product_id** (string) - Required - The ID of the trial product.
- **customer_account_id** (string) - Required - The ID of the customer's account.
- **amount** (integer) - Required - Set to 1 for the authorization step.
- **currency** (string) - Required - Set to 'USD'.

### Request Example
```json
{
  "product_id": "prod_trial_456",
  "customer_account_id": "cust_fghij",
  "amount": 1,
  "currency": "USD"
}
```

### Response
#### Success Response (200)
- **order_status** (string) - The status of the order, expected to be 'void_ok' for successful auth-void.
- **authorization_status** (string) - Status of the authorization transaction.
- **void_status** (string) - Status of the void transaction.

#### Response Example
```json
{
  "order_status": "void_ok",
  "authorization_status": "authorized",
  "void_status": "voided"
}
```
```

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

### Create Subscription

Source: https://docs.solidgate.com/billing/subscription-overview

Initiate a subscription for a customer by providing a product ID and customer account ID. The system handles payment processing and subscription initialization.

```APIDOC
## POST /api/subscriptions

### Description
Initiates a subscription for a customer. Requires a `product_id` and `customer_account_id`.

### Method
POST

### Endpoint
/api/subscriptions

### Parameters
#### Request Body
- **product_id** (string) - Required - The ID of the product to subscribe to.
- **customer_account_id** (string) - Required - The ID of the customer's account.

### Request Example
```json
{
  "product_id": "prod_12345",
  "customer_account_id": "cust_abcde"
}
```

### Response
#### Success Response (200)
- **subscription_id** (string) - The ID of the created subscription.
- **notification** (string) - A notification message regarding subscription creation.

#### Response Example
```json
{
  "subscription_id": "sub_zyxw987",
  "notification": "Subscription created successfully."
}
```
```

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

### Create Solidgate API Instance in PHP

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Initializes the Solidgate API client in PHP by providing your public and secret keys. This instance is used for making subsequent API requests.

```php
<?php

use SolidGate\API\Api;

$api = new Api('public_key', 'secret_key');

```

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

### Backend Setup and Partial Intent Updates

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Explains how to update a `partialIntent` object after backend setup. This method allows modifications to a predefined list of fields and returns an error for unauthorized updates.

```APIDOC
## Backend Setup and Partial Intent Updates

### Description
This section describes the backend setup process, specifically focusing on the `formMerchantData` function and its ability to update a predefined set of fields within a `partialIntent` object. Updates to fields not in the allowed list will result in an error.

### Method
POST (Implied, as it's an update operation)

### Endpoint
/websites/solidgate/partialIntent (Inferred)

### Parameters
#### Request Body
- **product_id** (string) - Required* - Identifier of the predefined product in UUID v4 format. Should be provided one of `product_id` or `product_price_id` for subscription flow.
- **product_price_id** (string) - Required* - Price ID of the predefined product. To get `product_price_id`, use get product prices. Should be provided one of `product_id` or `product_price_id` for subscription flow.
- **customer_account_id** (string) - Required* - Customer ID in the merchant’s system. Required for the subscription workflow.
- **amount** (integer) - Required* - Order amount - integer without fractional component. Can be 0 for zero-amount authorization. Required for one-time payment workflow.
- **currency** (string) - Required* - Three-letter currency code as per ISO-4217 standard. Required for one-time payment workflow.
- **order_description** (string) - Optional - Order description in your system and for bank processing. Recommended to be brief (under 100 characters).
- **order_items** (string) - Optional - Order items in UTF-8 code.
- **order_date** (string) - Optional - Date of order creation in format YYYY-MM-DD-HH-MM-SS.
- **order_number** (integer) - Optional - Number of payments by the customer.
- **settle_interval** (integer) - Optional - Delay before transaction settlement in hours (e.g., 240 for 10 days).
- **force3ds** (boolean) - Optional - Routing payments flag for 3DS flow.
- **customer_email** (string) - Optional - Customer email. Specific rules apply if the email was initially provided or empty.
- **traffic_source** (string) - Optional - Source of traffic.
- **transaction_source** (string) - Optional - Source of transactions on the merchant site.
- **order_metadata** (object) - Optional - Metadata for storing additional structured information (up to 10 key-value pairs, 380 characters per field).
- **success_url** (string) - Optional - URL to redirect a customer to a custom Success Screen.
- **fail_url** (string) - Optional - URL to redirect a customer to a custom Fail Screen.

### Request Example
```json
{
  "product_id": "faf3b86a-1fe6-4ae5-84d4-ab0651d75db2",
  "customer_account_id": "4dad42f878",
  "amount": 1020,
  "currency": "EUR",
  "order_description": "Premium package",
  "order_items": "item5",
  "order_date": "2024-02-21 11:21:30",
  "order_number": "4",
  "settle_interval": 48,
  "force3ds": true,
  "customer_email": "user-one@mail.com",
  "traffic_source": "Instagram",
  "transaction_source": "Main menu",
  "order_metadata": {
    "coupon_code": "NY2024",
    "partner_id": "123989"
  },
  "success_url": "http://merchant.example/success",
  "fail_url": "http://merchant.example/fail"
}
```

### Response
(Details on response structure and success/error codes would typically go here, but are not provided in the input text.)
```

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

### One-Time Payment JSON Example

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

This is an example of a JSON object representing a one-time payment transaction. It includes essential details like order ID, amount, currency, and future usage preferences.

```json
{
  "order_id": "123456",
  "amount": 1020,
  "currency": "USD",
  "future_usage": {
    "payment_type": "one-time"
  },
  "order_description": "Premium package"
}
```

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

### One-Time Payment JSON Example

Source: https://docs.solidgate.com/payments/integrate/payment-form/resign-payment-form

Example JSON payload for initiating a one-time payment. Includes order details, customer information, billing address, device information, and URLs for success/failure redirection.

```json
{
  "order_id": "123456",
  "recurring_token": "7ats8da7sd8-a66dfa7-a9s9das89t",
  "amount": 1020,
  "currency": "USD",
  "order_description": "Premium package",
  "order_items": "item1, item2",
  "order_date": "2024-12-21 11:21:30",
  "order_number": 1,
  "type": "auth",
  "settle_interval": 48,
  "retry_attempt": 1,
  "force3ds": true,
  "customer_date_of_birth": "2000-11-21",
  "customer_email": "test@solidgate.com",
  "customer_first_name": "John",
  "customer_last_name": "Snow",
  "customer_phone": "12120001111",
  "ip_address": "8.8.8.8",
  "traffic_source": "Instagram",
  "transaction_source": "main_menu",
  "purchase_country": "CHN",
  "geo_country": "GBR",
  "geo_city": "New Castle",
  "billing_address": {
    "address": "Street 3D, Apartment 343",
    "country": "United States",
    "state": "Delaware",
    "city": "New Castle",
    "zip_code": "03127"
  },
  "language": "en",
  "website": "https://google.com",
  "device": "iPhone 8 iOS 12.0",
  "device_sessions": [
    {
      "id": "dsid_3a20_f9c1_4cd8_89d3_1c5",
      "provider": "checkout"
    },
    {
      "id": "a0d24c8a-2b67-4b4b-bd39-d2efbe92a7f0",
      "provider": "adyen"
    }
  ],
  "platform": "WEB",
  "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (HTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36",
  "order_metadata": {
    "coupon_code": "NY2024",
    "partner_id": "123989"
  },
  "success_url": "https://merchant.example/success",
  "fail_url": "https://merchant.example/fail"
}
```

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

### Create Solidgate API Instance in Python

Source: https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form

Instantiates the Solidgate API client in Python with your public and secret keys. This client object is used to interact with the Solidgate payment services.

```python
from solidgate import ApiClient

client = ApiClient("public_key", "secret_key")

```

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

### SolidGate Error Response Example

Source: https://docs.solidgate.com/payments/testing

This example shows a typical error response structure for a declined transaction in SolidGate, including the error code and a descriptive message. This format helps in identifying the specific reason for the decline.

```json
{
  "code": "Guide \n The card issuer bank blocked the card for payments.3.01 ",
  "message": "Card is blocked"
}
```

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

### Initialize Vanilla JS Resign Form with Solidgate SDK

Source: https://docs.solidgate.com/payments/integrate/payment-form/resign-payment-form

This code demonstrates how to initialize the Solidgate Resign Form using Vanilla JavaScript. It calls the `PaymentFormSdk.resign` method with the necessary `resignRequest` and `formConfig` objects. Error handling for initialization failure is also included.

```javascript
const setupResignPaymentForm = async () => {
  try {
    const form = await PaymentFormSdk.resign(resignRequest, formConfig);
    
    // Now you can call payment form methods such as form.on, form.submit and more...
  } catch (error) {
    // Error will be thrown if payment form initialization fails.
    // You can handle it here.
  }
};
```

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

### Apple Pay Properties

Source: https://docs.solidgate.com/payments/integrate/payment-form/apple-pay-button

Details on the `apple_pay_merchant_domain` property and how it's automatically configured.

```APIDOC
## Apple Pay Properties

### `apple_pay_merchant_domain`

*   **Type**: string
*   **Description**: Domain where you have uploaded the domain-verification file. This is automatically configured from the internal database.
*   **Example**: `solidgate.com`
```