Official Zotapay PHP SDK

This is the official page of the Zotapay PHP SDK. It is intended to be used by developers who run modern PHP applications and would like to integrate our next generation payments platform.

Introduction

PHP SDK provides all the neccessary methods for integrating the Zotapay Merchant API. This SDK is used by clients, as well as all the related eCommerce plugins for mainstream PHP applications.

Requirements

• A functioning Zotapay Sandbox or Production account and related credentials
• PHP version 7.2.0 or greater
• Client URL Library (cURL) version 7.34.0 or greater
• JSON extension enabled

Usage

Main configuration

After all the files are loaded configuration is needed. This can be done with the static methods provided in Zotapay class. Configuration includes:

• Credentials
• API url - test or production environment
• Endpoint
• Logging threshold and location

API requests

After everything is setup all requests to the API are made with the corresponding classes:

• Deposit
• DepositCC (deposit with Credit card data)
• Payout
• OrderStatus
• OrdersReport

Every request class consist of public request method with data object parameter. There are also private methods for preparation of the data and the signature.

Making the request

First the data object has to be created and all the needed data setup with the setters (ex. DepositOrder).

After that the request class (ex. Deposit) is created and the request method is called with the data object as parameter.

Retrieving the response

Every request method returns response object with available getters. In every response object are included getters providing the code, the message and the data as they are received from the API. Also in every response object are included getters for the body of the response, the HTTP code and the JSON. All other getters are request specific and are available for easier usage of the response further.

Callback and Merchant redirect handlers

Classes for callbacks and redirects handling are available with the corresponding getters:

• ApiCallback
• MerchantRedirect

Additional resources

In addition DefaultLogger class is available for logging. The DefaultLogger includes eight methods for writing logs to the eight RFC 5424 levels (debug, info, notice, warning, error, critical, alert, emergency).

Examples

Examples are available in examples folder.

Loading and configuration:

• autoload.php loads all the needed files as bootstrap.
• config.php includes main configuration.

• If needed differnet endpoint can be set for different requests.

Requests:

• deposit.php - Deposit request
• deposit-cc.php - Deposit request with Credit card details
• payout.php - Payout request
• order-status.php - Order status request
• orders-report.php - Orders report request

Order Handlers:

• callback.php - API Callback
• merchant-redirect.php - API Merchant redirect

Logging:

• logger.php - DefaultLogger usage

Resources

The Zotapay API guide can be found on the official API Documentation pages for deposit and payout operations.

Support

This SDK is supported by Zotapay. For sign-up and sales inquiries, please contact [email protected]. For Support, please use [email protected] and include customer identifiable information, along with a description of the issue.