valiton/payum-payone

Payum 扩展。它提供了 PAYONE 支付集成。

3.0.0 2024-06-20 07:08 UTC

This package is auto-updated.

Last update: 2024-09-20 07:47:03 UTC


README

Payum 扩展。它提供了 PAYONE 支付集成

入门指南

使用 PayumBuilder 注册工厂和网关

use Payum\Core\GatewayFactoryInterface;
use Valiton\Payum\Payone\PayoneGatewayFactory;

$payumBuilder->addGatewayFactory('payone', function(array $config, GatewayFactoryInterface $coreGatewayFactory) {
    return new PayoneGatewayFactory($config, $coreGatewayFactory);
});

$payumBuilder->addGateway('payone', [
    'factory' => 'payone',
    'merchant_id' => 123456, // change this
    'sub_account_id' => 567890 // change this
    'portal_id' => 6543276, // change this
    'key' => '1Q2W3E4R5T6' // change this
]);

Payone 网关需要一些附加字段才能正常工作

$payment = new Payment();
$payment->setDetails([
    // add required key value pairs for the payment method
]);

请参阅支付方法文档,了解特定支付方法的字段。

Symfony 集成

Payum Bundle 2.0 至少需要 Symfony 2.8。如果您想使用较旧版本的 Symfony,请参阅 http://stackoverflow.com/questions/35896718/register-custom-gateway-with-payumbundle/35900365

安装 Payum Bundle 并根据其文档进行设置。

composer require payum/payum-bundle ^2.0

将 Payone Gateway Factory 注册为服务

# app/config/services.yml

services:
    app.payum.payone.factory:
        class: Payum\Core\Bridge\Symfony\Builder\GatewayFactoryBuilder
        arguments: [Valiton\Payum\Payone\PayoneGatewayFactory]
        tags:
            - { name: payum.gateway_factory_builder, factory: payone }

并配置网关的凭证

# app/config/config.yml

payum:
    gateways:
        payone:
            factory: payone
            merchant_id: 123456 # change this
            sub_account_id: 567890 # change this
            portal_id: 6543276 # change this
            key: 1Q2W3E4R5T6 # change this

现在您可以从 payum 服务中检索网关

$gateway = $this->get('payum')->getGeteway('payone');

交易状态 URL(商家后台)

在 PAYONE 商家界面 (PMI) 中,必须定义一个 交易状态 URL。此交易 URL 必须是一个非动态通知 URL。因此,Payum Bundle for symfony 提供了一个路由 payum_notify_do_unsafe。它使用静态参数 gateway 而不是动态令牌。

.../payment/notify/unsafe/{gateway}

对于 PAYONE,网关将是 payone

.../payment/notify/unsafe/payone

将此 URL 添加到 PMI 的 交易状态 URL 中。

许可证

MIT 许可证 (MIT)

版权所有 © 2016 Valiton GmbH

特此授予任何获得此软件及其相关文档副本(以下简称“软件”)的人免费使用软件的权利,不受任何限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许向软件提供者提供软件的人行使上述权利,前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性、适用于特定目的和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论这些责任是基于合同、侵权或其他原因,以及与软件或软件的使用或其他交易相关的任何损害。