# Use the PHP SDK

> Learn how to install and use the PHP SDK to develop apps

<AudienceInfo audiences={['developers']} />

{/* vale Payabli.We = NO */}

{/* First person rule off for Quickstart */}

Payabli offers a Software Development Kit (SDK) for the PHP programming language.
The PHP SDK can be installed in your projects to support app development and provide type safety when calling Payabli's APIs.
Most development environments can use the SDK to generate code suggestions and inline documentation.
See the [`payabli/payabli`](https://packagist.org/packages/payabli/payabli) package for more information.

## Dependencies

Before you begin, make sure you have the following installed on your machine:

* [PHP](https://www.php.net/downloads.php) (8.1 or higher)
* [Composer](https://getcomposer.org/download/)
* [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)

## Use the SDK

This section shows you how to install and use the Payabli SDK in a new PHP project.
The example code shows how to use the SDK to make a transaction with the `moneyIn->getpaid` method.
The `moneyIn->getpaid` method calls the [MoneyIn/getpaid](/developers/api-reference/moneyin/make-a-transaction) endpoint.

<Note>
  Method names in the SDK correspond to endpoint names in the API reference.
  For example: the `notification->addNotification` method calls the [POST Notification](/developers/api-reference/notification/add-notification) endpoint.
</Note>

<Steps>
  <Step title="Create a new PHP project">
    Open your terminal and run the following commands to create a new PHP project:

    ```bash
    mkdir my-payabli-app
    cd my-payabli-app
    ```
  </Step>

  <Step title="Install the SDK">
    Run the following command to install the Payabli SDK:

    ```bash
    composer require payabli/payabli
    ```
  </Step>

  <Step title="Create a new file">
    Create a new file called `index.php` in the root of your `my-payabli-app` directory:

    ```bash
    touch index.php
    ```

    Open the `index.php` file in your code editor.
  </Step>

  <Step title="Make a transaction">
    The interactive walkthrough displays code examples alongside step-by-step explanations.

    Follow the walkthrough to use the SDK in your PHP code.

    <CodingWalkthrough title="Use the PHP SDK" src="https://files.buildwithfern.com/payabli.docs.buildwithfern.com/678889d6bb597894da24f6df4b57da6cb3be84b11485243d633e44be367893d6/snippets/walkthroughs/php-sdk.mdx" />

    {/* Hidden markdown content for server rendering and AI ingestion */}

    <div>
      /// Include autoloader and import client

      Import the Payabli SDK to make it available in your code.

      ```php
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;
      ```

      /// Initialize the client

      Create an authenticated client instance with your API key. This client has methods that call Payabli's API endpoints.

      ```php focus=7
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;

      $client = new PayabliClient("REPLACE_WITH_YOUR_API_KEY");
      ```

      /// Import request classes

      Import the specific request and type classes needed for payment processing.

      ```php focus=7-11
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;

      use Payabli\MoneyIn\Requests\RequestPayment;
      use Payabli\MoneyIn\Types\TransRequestBody;
      use Payabli\Types\PayorDataRequest;
      use Payabli\Types\PaymentDetail;
      use Payabli\Types\PayMethodCredit;

      $client = new PayabliClient("REPLACE_WITH_YOUR_API_KEY");
      ```

      /// Define the entrypoint

      Define your entrypoint. Get this value from your Payabli account.

      ```php focus=15
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;

      use Payabli\MoneyIn\Requests\RequestPayment;
      use Payabli\MoneyIn\Types\TransRequestBody;
      use Payabli\Types\PayorDataRequest;
      use Payabli\Types\PaymentDetail;
      use Payabli\Types\PayMethodCredit;

      $client = new PayabliClient("REPLACE_WITH_YOUR_API_KEY");

      $entrypoint = "REPLACE_WITH_YOUR_ENTRYPOINT";
      ```

      /// Build the payment request

      Construct a request object that contains all the necessary fields to process a transaction. Include payment details, a payment method, and customer data.

      ```php focus=17-38
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;

      use Payabli\MoneyIn\Requests\RequestPayment;
      use Payabli\MoneyIn\Types\TransRequestBody;
      use Payabli\Types\PayorDataRequest;
      use Payabli\Types\PaymentDetail;
      use Payabli\Types\PayMethodCredit;

      $client = new PayabliClient("REPLACE_WITH_YOUR_API_KEY");

      $entrypoint = "REPLACE_WITH_YOUR_ENTRYPOINT";

      $request = new RequestPayment([
          'body' => new TransRequestBody([
              'customerData' => new PayorDataRequest([
                  'customerId' => 4440,
              ]),
          'entryPoint' => $entrypoint,
              'ipaddress' => "255.255.255.255",
              'paymentDetails' => new PaymentDetail([
                  'serviceFee' => 0,
                  'totalAmount' => 100,
              ]),
              'paymentMethod' => new PayMethodCredit([
                  'cardcvv' => "999",
                  'cardexp' => "02/27",
                  'cardHolder' => "Kassiane Cassian",
                  'cardnumber' => "4111111111111111",
                  'cardzip' => "12345",
                  'initiator' => "payor",
                  'method' => "card",
              ]),
          ]),
      ]);
      ```

      /// Execute the transaction

      Call `moneyIn->getpaid()` to process the transaction. The client calls Payabli's `POST /MoneyIn/getpaid` endpoint.

      ```php focus=40
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;

      use Payabli\MoneyIn\Requests\RequestPayment;
      use Payabli\MoneyIn\Types\TransRequestBody;
      use Payabli\Types\PayorDataRequest;
      use Payabli\Types\PaymentDetail;
      use Payabli\Types\PayMethodCredit;

      $client = new PayabliClient("REPLACE_WITH_YOUR_API_KEY");

      $entrypoint = "REPLACE_WITH_YOUR_ENTRYPOINT";

      $request = new RequestPayment([
          'body' => new TransRequestBody([
              'customerData' => new PayorDataRequest([
                  'customerId' => 4440,
              ]),
          'entryPoint' => $entrypoint,
              'ipaddress' => "255.255.255.255",
              'paymentDetails' => new PaymentDetail([
                  'serviceFee' => 0,
                  'totalAmount' => 100,
              ]),
              'paymentMethod' => new PayMethodCredit([
                  'cardcvv' => "999",
                  'cardexp' => "02/27",
                  'cardHolder' => "Kassiane Cassian",
                  'cardnumber' => "4111111111111111",
                  'cardzip' => "12345",
                  'initiator' => "payor",
                  'method' => "card",
              ]),
          ]),
      ]);

      $result = $client->moneyIn->getpaid($request);
      ```

      /// Show the result

      Log the transaction response. Check the output to see if the transaction was successful.

      ```php focus=42
      <?php
      // index.php
      require_once __DIR__ . '/vendor/autoload.php';

      use Payabli\PayabliClient;

      use Payabli\MoneyIn\Requests\RequestPayment;
      use Payabli\MoneyIn\Types\TransRequestBody;
      use Payabli\Types\PayorDataRequest;
      use Payabli\Types\PaymentDetail;
      use Payabli\Types\PayMethodCredit;

      $client = new PayabliClient("REPLACE_WITH_YOUR_API_KEY");

      $entrypoint = "REPLACE_WITH_YOUR_ENTRYPOINT";

      $request = new RequestPayment([
          'body' => new TransRequestBody([
              'customerData' => new PayorDataRequest([
                  'customerId' => 4440,
              ]),
          'entryPoint' => $entrypoint,
              'ipaddress' => "255.255.255.255",
              'paymentDetails' => new PaymentDetail([
                  'serviceFee' => 0,
                  'totalAmount' => 100,
              ]),
              'paymentMethod' => new PayMethodCredit([
                  'cardcvv' => "999",
                  'cardexp' => "02/27",
                  'cardHolder' => "Kassiane Cassian",
                  'cardnumber' => "4111111111111111",
                  'cardzip' => "12345",
                  'initiator' => "payor",
                  'method' => "card",
              ]),
          ]),
      ]);

      $result = $client->moneyIn->getpaid($request);

      var_dump($result);
      ```
    </div>
  </Step>

  <Step title="Run the app">
    Run the app with the following command:

    ```bash
    php index.php
    ```
  </Step>

  <Step title="Check the result">
    Check the console output for the result of the transaction.
    A successful transaction returns output like this:

    ```txt
        array(4) {
            ["responseText"]=>
            string(7) "Success"
            ["isSuccess"]=>
            bool(true)
            ["pageIdentifier"]=>
            NULL
            ["responseData"]=>
            array(8) {
                ["authCode"]=>
                string(6) "TAS003"
                ["referenceId"]=>
                string(36) "255-67bc92c141e24f474f60c1968fcba0cd"
                ["resultCode"]=>
                int(1)
                ["resultText"]=>
                string(8) "Approved"
                ["avsResponseText"]=>
                string(35) "No Match, No address or ZIP match"
                ["cvvResponseText"]=>
                string(14) "CVV2/CVC2 match"
                ["customerId"]=>
                int(4440)
                ["methodReferenceId"]=>
                NULL
            }
        }
    ```
  </Step>
</Steps>

<Note>
  In production, we recommend that you pass a stored method ID to the `paymentMethod` object instead of card details.
  See more information in [Tokenization Overview](/guides/platform-tokenization-overview).
</Note>

## SDK example app

The SDK example app is a basic web app built with the Payabli PHP SDK.
It demonstrates how to manage customers and use the temporary token flow with the SDK.
The code is publicly available in the [example repository](https://github.com/payabli/examples/tree/main/sdk/php-sdk).

<Frame caption="Customer creation page">
  <img src="https://files.buildwithfern.com/payabli.docs.buildwithfern.com/d440856d350fd1d5a41c108ca9145534f79f17f2e3a0bca8038ba370ee594b83/images/sdk-example-app.png" alt="customer creation page of SDK example app" />
</Frame>

### Set up the app

Follow these steps to set up the SDK example app on your local machine:

<Steps>
  <Step title="Clone the repository">
    Open your terminal and run the following command to clone the SDK example app repository:

    ```bash
    git clone https://github.com/payabli/examples
    ```
  </Step>

  <Step title="Navigate to the app directory">
    In your terminal, navigate to the directory containing the SDK example app:

    ```bash
    cd examples/sdk/php-sdk
    ```
  </Step>

  <Step title="Install the dependencies">
    Install the dependencies with the following command:

    ```bash
    composer install
    ```
  </Step>

  <Step title="Copy the environment template">
    Copy the`.env.template` file to a new file called `.env`:

    ```bash
    cp .env.template .env
    ```
  </Step>

  <Step title="Fill in your environment variables">
    Open the `.env` file in your code editor. Set `PAYABLI_KEY` to a private API token, `PAYABLI_ENTRY` to your Payabli entrypoint, and `PAYABLI_PUBLIC_TOKEN` to a public API token:

    ```bash
      # your Payabli Private API token
      PAYABLI_KEY="o.Oim...Mekgjw="
      # your Payabli entrypoint
      PAYABLI_ENTRY="41xxxxxa7e"
      # your Payabli Public API token
      PAYABLI_PUBLIC_TOKEN="o.Oim...Mekgjw="
    ```
  </Step>

  <Step title="Start the development server">
    Run this command to start the development server, and open the app in your browser:

    ```bash
    composer run serve
    ```
  </Step>
</Steps>

### Use the app

The SDK example app has three pages:

1. **Create Customer** - Create a new customer in the Payabli entrypoint.
2. **List Customers** - View a list of all customers in the Payabli entrypoint.
3. **Make Transaction** - Make a transaction using the temporary token flow.

#### Create customer

The **Create Customer** page has a form that allows you to create a new customer.
Fill in the form with the customer's information and click the "Create" button.
If the customer is created successfully, a green success message appears below the button.

#### List customers

The **List Customers** page has a table of all customers in the entrypoint.
You can view the customer's information, including their name, email address, and ZIP Code.
Click the "X" button on the right side of a customer's row to delete the customer.
If the customer is deleted successfully, the row is removed from the table.

#### Make transaction

The **Make Transaction** page contains an EmbeddedMethod UI component using the temporary token flow.
Fill in the form with payment information and click the "Process" button when the payment information is valid.
The app performs these steps:

1. The embedded component saves the payment method as a temporary token and sends it to the server.
2. The server converts the temporary token to a permanent token with the **POST TokenStorage/add** endpoint.
3. The server uses the permanent token to make a transaction with the **POST MoneyIn/getpaid** endpoint.

If everything is successful, a green success message appears below the embedded component.
See [Extend embedded components with the temporary token flow](/guides/platform-developer-tokenization-temp-flow) for more information.

In the **List Customers** page, you can delete a customer by clicking the red "X" button on the right side of the customer's row.
If the customer is deleted successfully, the row is removed from the table.