README

This is a \"swagger\" definition of application programming interface of the MúzaPay by Benefit Plus e-commerce payment gateway. You may leverage this API from your e-shop to integrate payments by employee-benefits-programme funds. This version of the programme uses mobile payment application MúzaPay. <br/><br/> Requests signing

All requests except /auth/token must be signed by \"SHA-256 with RSA\" (RSASSA-PKCS1-v1_5, RFC 8017 chapter 8.2) electronic signatures. See online gateway documentation for details.

Change log

• v2 - 2025-06-26
  • Added HEALTH value to productCode enum as mandated by the Czech state legislation.
  • amountAuthorized in PaymentStateResponse renamed to remainingAmount to better capture its meaining.
  • Added HTTP 410 Gone response to the cancelPayment() operation.
  • Corrected pattern of orderReferenceCode
  • Multiple corrections of the documentation, examples and field ordering changes - non-impacting. <br/><br/>

For more information, please visit https://profirmy.benefit-plus.cz/podpora/.

Installation & Usage

Requirements

PHP 7.4 and later. Should also work with PHP 8.0.

Composer

To install the bindings via Composer, add the following to composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/wpify/benefit-plus-gateway-sdk.git"
    }
  ],
  "require": {
    "wpify/benefit-plus-gateway-sdk": "*@dev"
  }
}

Then run composer install

Manual Installation

Download the files and include autoload.php:

<?php
require_once('/path/to/OpenAPIClient-php/vendor/autoload.php');

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');



// Configure Bearer (JWT) authorization: bearerAuth
$config = BenefitPlusGatewaySdk\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new BenefitPlusGatewaySdk\Api\LandingPageApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);

try {
    $result = $apiInstance->getLandingPage();
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling LandingPageApi->getLandingPage: ', $e->getMessage(), PHP_EOL;
}

API Endpoints

All URIs are relative to https://api.gate.muzapay.cz

Models

• AuthenticationRequest
• AuthenticationResponse
• BadRequestErrorResponse
• Currency
• ErrorResponse
• GoneResponse
• InitPaymentRequest
• InitPaymentResponse
• PaymentStateResponse

Authorization

Authentication schemes defined for the API:

basicAuth

• Type: HTTP basic authentication

bearerAuth

• Type: Bearer authentication (JWT)

Tests

To run the tests, use:

composer install
vendor/bin/phpunit

Author

partneri@benefit-plus.cz

About this package

This PHP package is automatically generated by the OpenAPI Generator project:

• API version: 2.0
  • Generator version: 7.12.0
• Build package: org.openapitools.codegen.languages.PhpClientCodegen