PHPackages                             apoca/laravel-sibs-payments - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. apoca/laravel-sibs-payments

ActiveLibrary[HTTP & Networking](/categories/http)

apoca/laravel-sibs-payments
===========================

Laravel library to communicate with SIBS - Open Payment Platform.

v1.4.4(6y ago)342.3k4[5 issues](https://github.com/apoca/laravel-sibs-payments/issues)[3 PRs](https://github.com/apoca/laravel-sibs-payments/pulls)MITPHPPHP ^7.2

Since Mar 15Pushed 3y ago3 watchersCompare

[ Source](https://github.com/apoca/laravel-sibs-payments)[ Packagist](https://packagist.org/packages/apoca/laravel-sibs-payments)[ Docs](https://github.com/apoca/laravel-sibs-payments)[ RSS](/packages/apoca-laravel-sibs-payments/feed)WikiDiscussions master Synced yesterday

READMEChangelog (9)Dependencies (7)Versions (20)Used By (0)

laravel-sibs-payments
=====================

[](#laravel-sibs-payments)

[![Build Status](https://camo.githubusercontent.com/fc633b4216c461ef73b79940468c2c1810f1003d8629a5312176462d9f0e6f20/68747470733a2f2f7472617669732d63692e6f72672f61706f63612f6c61726176656c2d736962732d7061796d656e74732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/apoca/laravel-sibs-payments)[![Codacy Badge](https://camo.githubusercontent.com/51b8055c071f78c77afa76ee401ffe2996c87e65262cc10468a44f83c287d19f/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6537666536386132306136323464343038343035303434396432333133356134)](https://www.codacy.com/app/apoca/laravel-sibs-payments?utm_source=github.com&utm_medium=referral&utm_content=apoca/laravel-sibs-payments&utm_campaign=Badge_Grade)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/625c77208a0e0c1d7f984aed36c0a17b84bcd5ff216598f1b8475e1a88f0086f/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f61706f63612f6c61726176656c2d736962732d7061796d656e74732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/apoca/laravel-sibs-payments/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/58ce910b575b34809b07984c3ba081012988b5883cc30baa304af7a4b404483d/68747470733a2f2f706f7365722e707567782e6f72672f61706f63612f6c61726176656c2d736962732d7061796d656e74732f762f737461626c65)](https://packagist.org/packages/apoca/laravel-sibs-payments)[![Total Downloads](https://camo.githubusercontent.com/f889b8d88533a291373469dccc145928c55611e444ba76f6d04628b2ac8c5688/68747470733a2f2f706f7365722e707567782e6f72672f61706f63612f6c61726176656c2d736962732d7061796d656e74732f646f776e6c6f616473)](https://packagist.org/packages/apoca/laravel-sibs-payments)[![License](https://camo.githubusercontent.com/0e8c8f146c46ac4565a9541681bcc7811bd4793508ddc188e4accbbdbf1fcb42/68747470733a2f2f706f7365722e707567782e6f72672f61706f63612f6c61726176656c2d736962732d7061796d656e74732f6c6963656e7365)](https://packagist.org/packages/apoca/laravel-sibs-payments)

Laravel library to communicate with [SIBS - Open Payment Platform](https://www.sibs-international.com/). The library includes payments: VISA, MASTER, AMEX, VPAY, MAESTRO, VISADEBIT, VISAELECTRON.

Contents
--------

[](#contents)

- [laravel-sibs-payments](#laravel-sibs-payments)
    - [Installation](#installation)
    - [Usage](#usage)
    - [Feedback](#feedback)
    - [Contributing](#contributing)
    - [License](#license)
    - [Author](#author)

Installation
------------

[](#installation)

Require this package with composer. It is recommended to only require the package for development.

```
composer require apoca/laravel-sibs-payments
```

Laravel 5.5 uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider.

### Laravel 5.5+:

[](#laravel-55)

If you don't use auto-discovery, add the ServiceProvider to the providers array in config/app.php

```
Apoca\Sibs\SibsServiceProvider::class,
```

If you want to use the facade, add this to your facades in app.php:

```
'Sibs' => Apoca\Sibs\Facade\Sibs::class,
```

Copy the package config to your local config with the publish command:

```
php artisan vendor:publish --provider="Apoca\Sibs\SibsServiceProvider"
```

Usage
-----

[](#usage)

### COPYandPAY Integration Guide

[](#copyandpay-integration-guide)

1. Prepare the checkout

First, perform a server-to-server POST request to prepare the checkout with the required data, including the order type, amount and currency. The response to a successful request is a JSON string with an id, which is required in the second step to create the payment form.

```
$request = [
    'brand' => 'CHECKOUT',
    'amount' => 100,
    'currency' => 'EUR',
    'type' => 'DB',
    'optionalParameters' => [],
];

$response = Sibs::checkout($request)->pay();
```

#### Response

[](#response)

```
{
  "status": 200,
  "response": {
    "result":{
        "code":"000.200.100",
        "description":"successfully created checkout"
      },
      "buildNumber":"0dbf5028d176bc143baf9657d4d786f6372f4a83@2019-03-29 10:03:17 +0000",
      "timestamp":"2019-03-29 11:27:15+0000",
      "ndc":"E45186C4789C89A23E66D8DDA57A8586.uat01-vm-tx01",
      "id":"E45186C4789C89A23E66D8DDA57A8586.uat01-vm-tx01"
  }
}
```

2. Create the payment form

- The checkout's id that you got in the response from step 1

```

```

- The shopperResultUrl, which is the page on your site where the customer should be redirected to after the payment is processed and the brands that will be available.

```

```

3. Get the payment status (see step 1)

```
$response = Sibs::status($response->response->id);

```

```
{
  "status": 400,
  "response": {
    "result":{
        "code":"200.300.404",
        "description":"invalid or missing parameter",
        "parameterErrors": [
          {
            "name": "entityId",
            "value": "8a8294185332bbe601533754724914d9",
            "message": "is not an allowed parameter"
          }
        ]
      },
      "buildNumber":"",
      "timestamp":"2019-03-29 11:27:15+0000",
      "ndc":"89C42801E79302B0E75520C4A793121D.uat01-vm-tx03"
  }
}
```

NOTE: You'll receive and error code 400, because you need an entity key approved by [sibs](https://www.sibs-international.com/).

### Server-to-Server

[](#server-to-server)

Sending the request parameters server-to-server and receive the payment response synchronously. NOTE: This integration variant requires you to collect the card data which increases your PCI-compliance scope. If you want to minimize your PCI-compliance requirements, we recommend that you use COPYandPAY.

You can perform different types of initial payments using our server-to-server REST API.

- Preauthorization (PA)
- Debit (DB)

```
$request = [
    'amount' => 102.34,
    'currency' => 'EUR',
    'brand' => 'VISA',
    'type' => 'DB',
    'number' => 4200000000000000,
    'holder' => 'Jane Jones',
    'expiry_month' => 05,
    'expiry_year' => 2020,
    'cvv' => 123,
    'optionalParameters' => [],
];
$response = Sibs::checkout($request)->pay();
```

### Asynchronous Server-to-Server MBWay

[](#asynchronous-server-to-server-mbway)

In an asynchronous workflow a redirection takes place to allow the account holder to complete/verify the payment.
Put the brand parameter equals to "MBWAY" and the type equals to PA. The accountId should be a phone number like this <country\_dial\_code#phone\_number>.

```
$request = [
    'amount' => 10.44,
    'currency' => 'EUR',
    'brand' => 'MBWAY',
    'type' => 'PA',
    'accountId' => '351#911222111',
    'optionalParameters' => [],
];
$response = Sibs::checkout($request)->pay();
```

If you are in test mode put the mode parameter on sibs config file equals to test.

#### Response Example

[](#response-example)

```
{
  "status": 200,
  "response": {
    "id":"8ac7a4a26982228701698db398cf05ee",
      "paymentType":"DB",
      "paymentBrand":"VISA",
      "amount":"102.34",
      "currency":"EUR",
      "descriptor":"2302.8463.4825 OPP_Channel ",
      "result":{
        "code":"000.100.110",
        "description":"Request successfully processed in 'Merchant in Integrator Test Mode'"
      },
      "card":{
        "bin":"420000",
        "last4Digits":"0000",
        "holder":"Jane Jones",
        "expiryMonth":"05",
        "expiryYear":"2020"
      },
      "risk":{
        "score":"100"
      },
      "buildNumber":"699e422a79444128a09e7d5d75eb187a99e8b3f3@2019-03-15 04:42:21 +0000",
      "timestamp":"2019-03-17 22:09:12+0000",
      "ndc":"8a8294185332bbe601533754724914d9_db6237eaf4b247ca99e4f917c5ca2943"
  }
}
```

[See oficial SIBS api reference](https://sibs.docs.onlinepayments.pt/)

Feedback
--------

[](#feedback)

We'd love to get feedback on how you're using laravel-sibs-payments and things we could add to make this tool better. Feel free to contact us at

Contributing
------------

[](#contributing)

We'd love to get feedback on how you're using *laravel-sibs-payments* and things we could add to make this tool better. Feel.

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details

Author
------

[](#author)

- **Miguel Vieira** - *Initial work* - [apoca](https://github.com/apoca)

See also the list of [contributors](https://github.com/apoca/laravel-sibs-payments/contributors) who participated in this project.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 78.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

14

Last Release

2554d ago

PHP version history (2 changes)v1.0.4PHP ^7.1

v1.1.0PHP ^7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/2332017db17e187d49b6a593edba7ea0e09b044e54c99880d05c60f5d5a7403a?d=identicon)[apoca](/maintainers/apoca)

---

Top Contributors

[![apoca](https://avatars.githubusercontent.com/u/5594091?v=4)](https://github.com/apoca "apoca (25 commits)")[![miguelangelorodrigues](https://avatars.githubusercontent.com/u/24527747?v=4)](https://github.com/miguelangelorodrigues "miguelangelorodrigues (7 commits)")

---

Tags

amexmaestromastermbwaypaymentsrecurringsepavisavisadebitvisaelectronvpayhttplaravelrestweb servicepaymentsvisaamexmastermbwayMaestroVPAYmobile paymentsibsVISADEBITVISAELECTRON

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/apoca-laravel-sibs-payments/health.svg)

```
[![Health](https://phpackages.com/badges/apoca-laravel-sibs-payments/health.svg)](https://phpackages.com/packages/apoca-laravel-sibs-payments)
```

###  Alternatives

[srmklive/paypal

Laravel plugin For Processing Payments Through Paypal Express Checkout. Can Be Used Independently With Other Applications.

1.1k3.8M26](/packages/srmklive-paypal)[zoonman/pixabay-php-api

PixabayClient is a PHP HTTP client library to access Pixabay's API

3354.7k](/packages/zoonman-pixabay-php-api)[e-moe/guzzle6-bundle

Integrates Guzzle 6 into your Symfony application

11259.2k](/packages/e-moe-guzzle6-bundle)[laragear/api-manager

Manage multiple REST servers to make requests in few lines and fluently.

161.8k](/packages/laragear-api-manager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)