README

为Omnipay PHP支付处理库提供的2Checkout网关

Omnipay是一个不依赖于框架、多网关的PHP 5.3+支付处理库。此软件包实现了Omnipay的2checkout支持。

安装

通过Composer

$ composer require collizo4sky/omnipay-2checkout

用法

此软件包提供以下网关

• TwoCheckoutPlus
• TwoCheckoutPlus_Token

TwoCheckoutPlus

use Omnipay\Omnipay;

$gateway = Omnipay::create('TwoCheckoutPlus');
$gateway->setAccountNumber($this->account_number);
$gateway->setSecretWord($this->secret_word);
$gateway->setTestMode($this->is_sandbox_test());
// activate test mode by passing demo parameter to checkout parameters.
$gateway->setDemoMode($this->is_test_mode());


try {
    $formData = array(
        'firstName' => $order->get_billing_first_name(),
        'lastName' => $order->get_billing_last_name(),
        'email' => $order->get_billing_email(),
        'address1' => $order->get_billing_address_1(),
        'address2' => $order->get_billing_address_2(),
        'city' => $order->get_billing_city(),
        'state' => $order->get_billing_state(),
        'postcode' => $order->get_billing_postcode(),
        'country' => $order->get_billing_country(),
    );

    $order_cart = $order->get_items();

    $cart = array();

    $i = 0;
    foreach ($order_cart as $order_item_id => $product) {
        $product_id = $product['product_id'];
        $cart[$i]['name'] = $product['name'];
        $cart[$i]['quantity'] = $product['qty'];
        $cart[$i]['type'] = 'product';
        $cart[$i]['price'] = round($product['line_subtotal'] / $product['qty'], 2);
        $cart[$i]['product_id'] = $product_id;

        $i++;
    }

    if (($shipping_total = $order->get_shipping_total()) > 0) {
        $cart[] = array(
            'name' => 'Shipping Fee',
            'quantity' => 1,
            'type' => 'shipping',
            'price' => round($shipping_total, 2),
        );
    }

    if (($discount_total = $order->get_total_discount()) > 0) {
        $cart[] = array(
            'name' => 'Discount',
            'quantity' => 1,
            'type' => 'coupon',
            'price' => round($discount_total, 2),
        );
    }

    if (($tax_total = $order->get_total_tax()) > 0) {
        $cart[] = array(
            'name' => 'Tax Fee',
            'type' => 'tax',
            'quantity' => 1,
            'price' => round($tax_total, 2),
        );
    }

    $gateway->setCart($cart);

    $response = $gateway->purchase(
        array(
            'card' => $formData,
            'transactionId' => $order->get_order_number(),
            'currency' => 'USD',
            // add a query parameter to the returnUrl to listen and complete payment
            'returnUrl' => $this->returnUrl,
        )
    )->send();


    if ($response->isRedirect()) {
        $response->getRedirectUrl();

    } else {
        $error = $response->getMessage();
    }
} catch (Exception $e) {
    $e->getMessage();
}

TwoCheckoutPlus_Token

use Omnipay\Omnipay;

try {
    $gateway = Omnipay::create('TwoCheckoutPlus_Token');
    $gateway->setAccountNumber($this->account_number);
    $gateway->setTestMode($this->is_sandbox_test());
    $gateway->setPrivateKey($this->private_key);

    $formData = array(
        'firstName' => $order->get_billing_first_name(),
        'lastName' => $order->get_billing_last_name(),
        'email' => $order->get_billing_email(),
        'billingAddress1' => $order->get_billing_address_1(),
        'billingAddress2' => $order->get_billing_address_2(),
        'billingCity' => $order->get_billing_city(),
        'billingPostcode' => $order->get_billing_postcode(),
        'billingState' => $order->get_billing_state(),
        'billingCountry' => $order->get_billing_country(),
    );


    $purchase_request_data = array(
        'card' => $formData,
        'token' => sanitize_text_field($_POST['twocheckout_token']),
        'transactionId' => $order->get_order_number(),
        'currency' => 'USD',
        'amount' => $order->order_total,
    );

    $response = $gateway->purchase($purchase_request_data)->send();

    if ($response->isSuccessful()) {
        $transaction_ref = $response->getTransactionReference();
    } else {
        $error = $response->getMessage();
    }
} catch (Exception $e) {
    $e->getMessage();
}

有关通用用法说明，请参阅Omnipay的主要仓库。

支持

如果您在使用Omnipay时遇到一般性问题，我们建议在Stack Overflow上发帖。请确保添加omnipay标签，以便更容易被找到。

如果您想及时了解发布公告、讨论项目想法或提出更详细的问题，还可以订阅邮件列表。

如果您认为发现了错误，请使用GitHub问题跟踪器报告，或者更好的方法是分支库并提交拉取请求。

测试

$ composer test

安全性

如果您发现任何安全相关的问题，请通过电子邮件me@w3guy.com而不是使用问题跟踪器。

致谢

• Agbonghama Collins
• 所有贡献者

许可协议

MIT许可协议（MIT）。有关更多信息，请参阅许可文件。