PHPackages                             artesaos/moip-subscriptions - 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. artesaos/moip-subscriptions

ActiveLibrary

artesaos/moip-subscriptions
===========================

MoIP Subscriptions PHP Client

1.0.1(9y ago)10722MITPHP

Since Jun 1Pushed 9y ago6 watchersCompare

[ Source](https://github.com/artesaos/moip-subscriptions)[ Packagist](https://packagist.org/packages/artesaos/moip-subscriptions)[ RSS](/packages/artesaos-moip-subscriptions/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (10)Used By (0)

MoIP Subscriptions
------------------

[](#moip-subscriptions)

### Introdução

[](#introdução)

**MoIP Assinaturas** (Pagamentos Recorrentes) é um produto da **[MoIP](http://moip.com.br)**.

A Presente biblioteca cliente visa facilitar a integração / implementação da API de Assinaturas em projetos PHP.

#### Sobre o Projeto

[](#sobre-o-projeto)

O Projeto utiliza o framework ActiveResource **[Restinga](https://github.com/artesaos/restinga)**.

#### Documentação Oficial

[](#documentação-oficial)

A documentação do pacote é uma cópia da documentação oficial, que pode ser encontra em

#### Status do Projeto

[](#status-do-projeto)

Status atual da Cobertura do Pacote

EndpointImplementaçãoExemplos`coupons` (Cupons)100%0%`plans` (Planos)100%0%`customers` (Clientes)100%0%`subscriptions` (Assinaturas)100%0%`- invoices` (Faturas)100%0%`--- payments` (Pagamentos)100%0%`--- retries` (Re-rentativas)100%0%`users/preferences` (Preferências)0%0%#### Conteúdo da Documentação

[](#conteúdo-da-documentação)

- [Primeiros Passos](#primeiros-passos)
- [Instalação](#instala%C3%A7%C3%A3o)
- [Configuração](#configura%C3%A7%C3%A3o)
- [Intruções Gerais](#instru%C3%A7%C3%B5es-gerais)
- [Gerenciamento de Erros](#gerenciamento-de-erros)
- [Exemplos](#exemplos)

### Primeiros Passos

[](#primeiros-passos)

#### Instalação

[](#instalação)

Para instalar a biblioteca **moip-subscriptions**, você deve utilizar o composer para incluí-la como dependência em seu projeto.

```
composer require artesaos/moip-subscriptions

```

#### Configuração

[](#configuração)

Após instalar a biblioteca, você precisará configurar seu token e chave da API, bem como indicar se as chamadas serão feitas no ambiente de produção ou não:

```
use Artesaos\MoIPSubscriptions\MoIPSubscriptions;

$token = '0011001100110011001100110011';
$key = '10101010101010101010010101010101010';
$production = false;

// A chamada setCredentials recebe 3 parametros
// O Token da API, a Chave da API e a indicação de produção ou não (true/false)
MoIPSubscriptions::setCredentials($token, $key, $production);
```

#### Instruções Gerais:

[](#instruções-gerais)

Cada recurso / classe da API funciona praticamente da mesma forma, porem todos os métodos disponíveis estão (ou serão) documentados nesse manual. Alguns métodos herdados da biblioteca Restinga como `$resource->destroy()` mesmo que disponíveis, não fazem efeito contra a API.

#### Gerenciamento de Erros

[](#gerenciamento-de-erros)

Para gerenciar os erros que a API poderá exibir, você pode utilizar o método `->hasErrors()` para descobrir se houve algum erro na requisição, e o método `->getErrors()` que por sua vêz tem métodos como `->first()` e `->all()`.

O exemplo a seguir de gerenciamento de erros é baseado na classe `Plan`, mas não se preocupe que essa classe ainda não está coberta, você só precisa entender o fluxo dos erros agora.

Vamos no exemplo tentar alterar um plano com valor negativo, o que já sabemos que a API não permite. Faremos isso apenas para demonstrar o tratamento de errors.

```
use Artesaos\MoIPSubscriptions\Resources\Plan;

// Busca um Plano Já cadastrado com código 'plan123'
$plan = Plan::find('plan123');

// Configuramos um valor negativo no plano
$plan->amount = -2200;

// Se o plano não pode ser salvo
if(!$plan->save()) {
    // e se Existe alguma mensagem de erro disponível
    if ($plan->hasErrors()) {
        // Método 1: obter um array com as mensagens de erro
        $errors = $plan->getErrors()->all();
        // Método 2: obter apenas o primeiro erro (caso hajam mais de 1 erro)
        $error = $plan->getErrors()->first();
    }

}
```

### Exemplos

[](#exemplos)

@todo

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity69

Established project with proven stability

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 ~0 days

Total

8

Last Release

3629d ago

Major Versions

0.9.2 → 1.0.02016-06-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/799b2351104c65a512e9d428cce029e2e51cfa1ba10342ba50aba3bd5b71bf71?d=identicon)[hernandev](/maintainers/hernandev)

### Embed Badge

![Health badge](/badges/artesaos-moip-subscriptions/health.svg)

```
[![Health](https://phpackages.com/badges/artesaos-moip-subscriptions/health.svg)](https://phpackages.com/packages/artesaos-moip-subscriptions)
```

PHPackages © 2026

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