jlcd/api-cielo30-laravel

Cielo 3.0 API 的 Laravel 提供程序

0.1.1 2017-04-17 13:28 UTC

This package is not auto-updated.

Last update: 2024-09-15 03:29:10 UTC


README

描述

此提供程序使用 jlcd/api-cielo30 客户端,后者又使用 Cielo 的 官方 SDK

有关与 Cielo 通信的任何问题,应直接在 issues 中处理。

未测试 Laravel 5.0 之前的版本,并且不保证其功能。

安装

通过 Composer: composer require jlcd/api-cielo30-laravel

Laravel

将以下代码包含在 config/app.php 文件中的 providers 位置

(...)

   'providers' => [

    (...)

        /*
         * Package Service Providers...
         */

        // Cielo
        jlcd\CieloLaravel\CieloServiceProvider::class,

    (...)

    ],

(...)

在项目中执行 php artisan vendor:publish

Lumen

创建 config/cielo.php 文件

<?php

return [

    'merchant_id'  => env('CIELO_ID', 'default_id'),
    'merchant_key' => env('CIELO_KEY', 'default_key'),
    'environment'  => env('CIELO_ENV', 'default_environment'), // production | sandbox

];

bootstrap/app.php 中包含以下代码

(...)

$app->configure('cielo');
$app->register(jlcd\CieloLaravel\CieloServiceProvider::class);

(...)

配置

环境变量 CIELO_IDCIELO_KEYCIELO_ENV 应在 .env 文件中配置。

CIELO_ENV 的有效值是

  • 沙箱
  • 生产

例如:

CIELO_ID=123435678
CIELO_KEY=25fbb99341c739dd84a7b06ec78c2cac718838630f30b182d033ce2e621c34f3
CIELO_ENV=sandbox

作为替代,在执行 vendor:publish 后,可以直接在配置文件 config/cielo.php 中包含配置。

使用方法

使用 routes/web.php 文件的示例

进行支付

<?php

use jlcd\Cielo\Resources\CieloPayment;
use jlcd\Cielo\Resources\CieloCreditCard;
use jlcd\Cielo\Resources\CieloCustomer;
use jlcd\Cielo\Resources\CieloOrder;

Route::get('/', function () {
    $payment = new CieloPayment();
    $payment->setValue(1541);

    $creditCard = new CieloCreditCard();
    $creditCard->setCardNumber('1234432112344321');
    $creditCard->setExpirationDate('12/2018');
    $creditCard->setBrand('visa');
    $creditCard->setSecurityCode('888');
    $creditCard->setHolder('Fulano');
    $payment->setCreditCard($creditCard);

    $order = new CieloOrder();
    $order->setId('123');

    $customer = new CieloCustomer();
    $customer->setName('Fulano');

    $payment = app()->cielo->payment($payment, $order, $customer);
    dd($payment);
});

取消支付

<?php

use jlcd\Cielo\Resources\CieloPayment;

Route::get('/cancel/{id}', function ($id) {
    $payment = new CieloPayment();
    $payment->setId($id);
    $payment->setValue(1541);

    $payment = app()->cielo->cancelPayment($payment);
    dd($payment);
});

捕获支付

<?php

use jlcd\Cielo\Resources\CieloPayment;
Route::get('/capture/{id}', function ($id) {
    $payment = new CieloPayment();
    $payment->setId($id);
    $payment->setValue(1541);

    $payment = app()->cielo->capturePayment($payment);
    dd($payment);
});

卡号令牌化

<?php

use jlcd\Cielo\Resources\CieloCreditCard;
use jlcd\Cielo\Resources\CieloCustomer;

Route::get('/tokenize', function () {
    $creditCard = new CieloCreditCard();
    $creditCard->setCardNumber("1234432112344321");
    $creditCard->setHolder("Comprador T Cielo");
    $creditCard->setExpirationDate("12/2018");
    $creditCard->setBrand("Visa");

    $customer = new CieloCustomer();
    $customer->setName('Fulano');

    $token = app()->cielo->tokenizeCreditCard($creditCard, $customer);
    dd($token);
});

通过卡令牌进行支付

<?php

use jlcd\Cielo\Resources\CieloPayment;
use jlcd\Cielo\Resources\CieloCreditCard;
use jlcd\Cielo\Resources\CieloCustomer;
use jlcd\Cielo\Resources\CieloOrder;

Route::get('/paymenttoken/{id}', function ($id) {
    $payment = new CieloPayment();
    $payment->setValue(1541);

    $creditCard = new CieloCreditCard();
    $creditCard->setBrand('visa');
    $creditCard->setToken($id);
    $creditCard->setSecurityCode('888');
    $payment->setCreditCard($creditCard);

    $order = new CieloOrder();
    $order->setId('123');

    $customer = new CieloCustomer();
    $customer->setName('Fulano');

    $payment = app()->cielo->payment($payment, $order, $customer);
    dd($payment);
});

有关更详细的信息,请参阅所使用的客户端仓库(jlcd/api-cielo30)和官方文档(developercielo.github.io/Webservice-3.0/)。