phpsc/pagseguro

此软件包已被废弃且不再维护。没有建议的替代软件包。

与 PagSeguro API 集成的客户端

维护者

详细信息

github.com/PHPSC/pagseguro

源代码

安装量: 20 119

依赖项: 2

建议者: 0

安全: 0

星标: 171

关注者: 30

分支: 67

1.0.1 2017-05-28 22:04 UTC

Requires

Requires (Dev)

CC-BY-SA-2.5 d094c8c6a3ad2c0c8a32d816a8d2724f4e60876a

  • Luís Otávio Cobucci Oblonczyk <lcobucci.woop@gmail.com>

apiPagseguroPagamentoNotificacao

This package is auto-updated.

Last update: 2020-02-06 13:22:58 UTC

README

Atenção

该项目已停止开发。请随意进行分支并按需修改。

PagSeguro API

Gitter

Build Status Scrutinizer Code Quality Code Coverage

Total Downloads Latest Stable Version

PHP 5.6+ 的 PagSeguro 集成 API，应使用与 PSR-4 兼容的自动加载器。

安装

可以使用 Composer 安装此库。

基本示例

在此版本中可以管理

  • 请求（付款和订阅）；
  • 通知
  • 按代码搜索（付款和订阅）；
  • 取消订阅和收取订阅费。

访问凭证

要能够对 PagSeguro 进行请求，您必须配置访问凭证，可以是生产环境或沙盒环境。

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado

use PHPSC\PagSeguro\Credentials;
use PHPSC\PagSeguro\Environments\Production;
use PHPSC\PagSeguro\Environments\Sandbox;

/* Ambiente de produção: */

$credentials = new Credentials('EMAIL CADASTRADO NO PAGSEGURO', 'TOKEN DE ACESSO À API');

// ou 

$credentials = new Credentials(
    'EMAIL CADASTRADO NO PAGSEGURO', 
    'TOKEN DE ACESSO À API',
    new Production()
);

/* Ambiente de testes: */

$credentials = new Credentials(
    'EMAIL CADASTRADO NO PAGSEGURO', 
    'TOKEN DE ACESSO À API',
    new Sandbox()
);

请求

一组用于请求客户进行付款或订阅授权的服务。

付款

此服务负责请求付款，其基本流程是

Loja                                  PagSeguro
 |                                        |
 |----- (A) solicitação de compra ------->|
 |                                        | (B) realiza processamento
 |<---- (C) envia resposta ---------------|
 |                                        |
 |----- (D) redireciona o cliente ------->|
  • (A) 商店创建一个购买请求并发送给服务
  • (B) PagSeguro 处理请求
  • (C) PagSeguro 发送请求的响应（如果有错误则报告错误）
  • (D) 如果 (C) 的处理成功，将返回一个代码，商店应将客户重定向到 PagSeguro 进行付款

客户被商店重定向到 PagSeguro (D) 并授权付款后，他可以带着创建的交易代码被重定向回商店（取决于配置）

以下代码可以作为请求付款的基本示例

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use PHPSC\PagSeguro\Customer\Customer;
use PHPSC\PagSeguro\Items\Item;
use PHPSC\PagSeguro\Requests\Checkout\CheckoutService;

try {
    $service = new CheckoutService($credentials); // cria instância do serviço de pagamentos
    
    $checkout = $service->createCheckoutBuilder()
                        ->addItem(new Item(1, 'Televisão LED 500', 8999.99))
                        ->addItem(new Item(2, 'Video-game mega ultra blaster', 799.99))
                        ->getCheckout();
    
    $response = $service->checkout($checkout);
    
    //Se você quer usar uma url de retorno
    $checkout->setRedirectTo( "http://seu_dominio/uri/retorno" );
    
    //Se você quer usar uma url de notificação
    $checkout->setNotificationURL( "http://seu_dominio/admin/transacao/notificacao" );

    header('Location: ' . $response->getRedirectionUrl()); // Redireciona o usuário
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

订阅

此服务负责请求订阅授权（预授权付款），其基本流程是

Loja                                      PagSeguro
 |                                            |
 |----- (A) solicitação de assinatura ------->|
 |                                            | (B) realiza processamento
 |<---- (C) envia resposta -------------------|
 |                                            |
 |----- (D) redireciona o cliente ----------->|
  • (A) 商店创建一个订阅请求（手动或自动收费）并发送给服务
  • (B) PagSeguro 处理请求
  • (C) PagSeguro 发送请求的响应（如果有错误则报告错误）
  • (D) 如果 (C) 的处理成功，将返回一个代码，商店应将客户重定向到 PagSeguro 进行付款

客户被商店重定向到 PagSeguro (D) 并授权订阅后，他可以带着创建的订阅代码被重定向回商店（取决于配置）

以下代码可以作为请求手动订阅的基本示例，其中商店负责发送收费

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use DateTime;
use PHPSC\PagSeguro\Requests\PreApprovals\Period;
use PHPSC\PagSeguro\Requests\PreApprovals\PreApprovalService;

try {
    $service = new PreApprovalService($credentials); // cria instância do serviço de pagamentos
    
    $request = $service->createRequestBuilder()
                   ->setName('Nome da assinatura')
                   ->setPeriod(Period::MONTHLY)
                   ->setFinalDate(new DateTime('2014-12-31 23:59:59'))
                   ->setMaxTotalAmount(50)
                   ->setMaxPaymentsPerPeriod(1)
                   ->setMaxAmountPerPeriod(10)
                   ->getRequest();
    
    $response = $service->approve($request);

    header('Location: ' . $response->getRedirectionUrl()); // Redireciona o usuário
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

以下代码可以作为请求自动订阅的基本示例，其中收费将由 PagSeguro 控制

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use DateTime;
use PHPSC\PagSeguro\Requests\PreApprovals\Period;
use PHPSC\PagSeguro\Requests\PreApprovals\PreApprovalService;

try {
    $service = new PreApprovalService($credentials); // cria instância do serviço de pagamentos
    
    $request = $service->createRequestBuilder(false)
                   ->setName('Nome da assinatura')
                   ->setPeriod(Period::MONTHLY)
                   ->setFinalDate(new DateTime('2014-12-31 23:59:59'))
                   ->setAmountPerPayment(10)
                   ->setMaxTotalAmount(50)
                   ->getRequest();
    
    $response = $service->approve($request);

    header('Location: ' . $response->getRedirectionUrl()); // Redireciona o usuário
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

通知

此服务负责根据通知代码查找交易或订阅，用于跟踪付款或订阅的状态变更。其基本流程是

Loja                                  PagSeguro
 |                                        |
 |<---- (A) notifica alteração -----------|
 |                                        |
 |----- (B) solicita dados -------------->|
 |                                        |
 |<---- (C) envia resposta ---------------|
  • (A) PagSeguro 向配置在 PagSeguro 账户中的页面发送请求，通知状态变更
  • (B) 店铺通过通知代码查找交易或签名
  • (C) PagSeguro发送包含交易详细信息的请求响应

基本用法是

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

// Caso estiver testando, a linha abaixo deve estar descomentada (assim o pagseguro conseguirá enviar requisições locais via JavaScript)
// header("access-control-allow-origin: https://sandbox.pagseguro.uol.com.br");

use PHPSC\PagSeguro\Purchases\Subscriptions\Locator as SubscriptionLocator;
use PHPSC\PagSeguro\Purchases\Transactions\Locator as TransactionLocator;

try {
    $service = $_POST['notificationType'] == 'preApproval'
               ? new SubscriptionLocator($credentials)
               : new TransactionLocator($credentials); // Cria instância do serviço de acordo com o tipo da notificação
               
    $purchase = $service->getByNotification($_POST['notificationCode']);

    var_dump($purchase); // Exibe na tela a transação ou assinatura atualizada
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

通过代码查找

此服务负责从代码查找交易或签名，它应该用于查找交易/签名的完整数据。其基本流程是

Loja                                  PagSeguro
 |                                        |
 |----- (A) solicita dados -------------->|
 |                                        |
 |<---- (B) envia resposta ---------------|
  • (A) 店铺从交易/签名的代码（在付款请求中接收）查找交易
  • (B) PagSeguro发送包含交易/签名的详细信息的请求响应

用于查找交易的用法是

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use PHPSC\PagSeguro\Purchases\Transactions\Locator;

try {
    $service = new Locator($credentials); // Cria instância do serviço de localização de transações
    
    $transaction = $service->getByCode('CÓDIGO');

    var_dump($transaction); // Exibe na tela a transação
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

对于签名来说非常相似

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use PHPSC\PagSeguro\Purchases\Subscriptions\Locator;

try {
    $service = new Locator($credentials); // Cria instância do serviço de localização de assinaturas
    
    $subscription = $service->getByCode('CÓDIGO');

    var_dump($subscription); // Exibe na tela a assinatura
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

签名管理

签名服务允许从签名代码执行两个操作：收费（仅当签名是手动收费时）和取消。

收费

此方法负责为手动收费的签名执行新的收费。其基本流程是

Loja                                  PagSeguro
 |                                        |
 |----- (A) solicita dados -------------->|
 |                                        |
 |<---- (B) envia resposta ---------------|
  • (A) 店铺发送一个包含签名代码和项目详细信息的新的收费请求
  • (B) PagSeguro发送包含收费交易代码的请求响应

基本用法是

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use PHPSC\PagSeguro\Purchases\Subscriptions\SubscriptionService;

try {
    $service = new SubscriptionService($credentials); // Cria instância do serviço de gerenciamento de assinaturas
    
    $charge = $service->createChargeBuilder('CÓDIGO DA ASSINATURA')
                      ->addItem(new Item(1, 'Pagamento assinatura 1/4', 10))
                      ->getCharge();

    var_dump($service->charge($charge)); // Exibe na tela a resposta da cobrança
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

取消

此方法负责由店铺执行签名的取消。其基本流程是

Loja                                  PagSeguro
 |                                        |
 |----- (A) solicita dados -------------->|
 |                                        |
 |<---- (B) envia resposta ---------------|
  • (A) 店铺发送包含签名代码的取消请求
  • (B) PagSeguro发送请求响应

基本用法是

<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado e as credenciais foram configuradas em $credentials

use PHPSC\PagSeguro\Purchases\Subscriptions\SubscriptionService;

try {
    $service = new SubscriptionService($credentials); // Cria instância do serviço de gerenciamento de assinaturas
    
    var_dump($service->cancel('CÓDIGO DA ASSINATURA')); // Exibe na tela a resposta do cancelamento
} catch (Exception $error) { // Caso ocorreu algum erro
    echo $error->getMessage(); // Exibe na tela a mensagem de erro
}

使用许可

此库遵循Creative Commons Attribution-ShareAlike 2.5的使用条款

Bitdeli Badge