README

adyen-sdk

非官方SDK，用于PHP应用程序与Adyen REST API集成

要求

• PHP >= 5.4
• curl 扩展

安装

使用composer将包 adyen-sdk 添加到您的项目中

composer require gpupo/adyen-sdk

使用

初始设置

//...
use Gpupo\AdyenSdk\Factory;

$adyenSdk = Factory::getInstance()->setup([
    'client_user'       => 'foo',
    'client_password'   => 'bar',
    'version'           => 'test'
]);

记录（日志）

//...
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
//..
$logger = new Logger('foo');
$logger->pushHandler(new StreamHandler('Resources/logs/main.log', Logger::DEBUG));
$adyenSdk->setLogger($logger);

交易

以下示例中，假设 $data 拥有 这个结构

创建一个新的信用卡交易

//...
$request = $adyenSdk->createRequest($data);
$request->setEncryptedData($hash);
$manager = $adyenSdk->factoryManager('request');
$response = $manager->submit($request);

创建一个新的银行汇票交易

//...
$request->setType('boleto');
$response = $manager->submit($request); //acesso à url do boleto e outras informações
$response->getBarCodeReference(); // Linha digitável
$response->getExpirationDate(); // Data de Vencimento
$response->getUrl(); // Url Do Boleto
$response->getData(); // Parâmetro usado para compor a url para o boleto

捕获一个信用卡交易

//...
$request = $adyenSdk->createRequest($data);
$response = $manager->capture($request);

在一个交易中部分退款

//...
$request = $adyenSdk->createRequest($data);
$response = $manager->refund($request, 10.99);

上述示例中执行了10.99 R$的退款

取消一个交易

//...
$request = $adyenSdk->createRequest($data);
$response = $manager->cancelOrRefund($request);

每个响应中包含的信息

$response->getResultCode() 的可能值

$response->getCode() 的可能值

错误

$response->getErrorCode() 的可能值

对象属性

以下列表是自动从单元测试执行输出生成的

Client\Client

• 访问client
• 设置options成功
• 管理资源uri

Factory

• 集中创建对象

Payment\Request\Decorator\BoletoDecorator

• 转换为json

Payment\Request\Decorator\CreditCardDecorator

• 转换为json

Payment\Request\Manager

• 是请求管理员
• 执行新的发票请求并返回特定对象
• 执行信用卡支付授权并返回特定对象
• 在失败的请求中返回有问题的对象
• 执行捕获请求
• 执行Refund()请求
• 执行CancelOrRefund()请求

Payment\Request\Order\Order

• 具有getId()方法来访问Id
• 具有setId()方法来定义Id
• 具有getShopper()方法来访问Shopper
• 具有setShopper()方法来定义Shopper
• 具有getAmount()和setAmount()方法来访问和定义Amount
• 具有getAmountInt()方法来访问和定义Amount为“minor units”格式
• 具有getBillingAddress()方法来访问BillingAddress
• 具有setBillingAddress()方法来定义BillingAddress
• 具有getShippingAddress()方法来访问ShippingAddress
• 具有setShippingAddress()方法来定义ShippingAddress
• 具有getInstallments()方法来访问Installments
• 具有setInstallments()方法来定义Installments
• 具有getDeliveryDate()方法来访问DeliveryDate
• 具有setDeliveryDate()方法来定义DeliveryDate
• 具有getCreatedAt()方法来访问CreatedAt
• 具有setCreatedAt()方法来定义CreatedAt
• 实体是一个集合

支付请求订单购物者

• 具有访问FirstName的方法 getFirstName()
• 具有定义FirstName的方法 setFirstName()
• 具有访问LastName的方法 getLastName()
• 具有定义LastName的方法 setLastName()
• 具有访问Ip的方法 getIp()
• 具有定义Ip的方法 setIp()
• 具有访问Email的方法 getEmail()
• 具有定义Email的方法 setEmail()
• 具有通过左填充（左侧加零）访问SocialSecurityNumber的方法 getSocialSecurityNumber()
• 具有定义SocialSecurityNumber的方法 setSocialSecurityNumber()
• 实体是一个集合

支付请求请求

• 具有访问Order的方法 getOrder()
• 具有定义Order的方法 setOrder()
• 具有访问Type的方法 getType()
• 具有定义Type的方法 setType()
• 具有访问EncryptedData的方法 getEncryptedData()
• 具有定义EncryptedData的方法 setEncryptedData()
• 实体是一个集合

支付响应装饰器——发票装饰器

• 自定义字段
• 通用字段

支付响应装饰器——捕获装饰器

• 自定义字段
• 通用字段

支付响应装饰器——信用卡装饰器

• 自定义字段
• 通用字段

支付响应装饰器——问题装饰器

• 自定义字段
• 通用字段

支付响应装饰器——退款装饰器

• 自定义字段
• 通用字段