README

这是一个 Visa Checkout API 的 PHP 库。它允许您将 Visa Checkout 集成到您的 PHP 应用程序中，并使用 Visa 卡进行支付。

要求

• PHP 8.0 或更高版本
• Composer
• Visa Checkout 账户
• Visa Checkout SDK 账户
• Visa Checkout SDK 商户 ID
• Visa Checkout SDK API 密钥
• Visa Checkout SDK 共享密钥
• Visa Checkout SDK API 端点
• Visa Checkout SDK API 版本

安装

要安装库，您可以使用 Composer

composer require faso-dev/visa-checkout-sdk

用法

以下是一个使用 Visa 卡创建支付的库使用示例

    use FasoDev\VisaCheckoutSdk\CardData;
    use FasoDev\VisaCheckoutSdk\Config;
    use FasoDev\VisaCheckoutSdk\Credentials;
    use FasoDev\VisaCheckoutSdk\PaymentException;
    use FasoDev\VisaCheckoutSdk\VisaPay;
    
    $config = Config::make(
        Credentials::make(
            'VCO_USER_1234567890',
            'VCO_PASS_1234567890',
        ),
    );
    
    $config->putUserAgent('Your user agent'); // Optional
    $config->putTimeout(30); // seconds, default is 30, optional
    $config->putConnectTimeout(30); // seconds, optional
    $config->putProxy('Your proxy'); // optional
    $config->putBaseUrl('Your base url'); // optional, but util if VISA change the base url
    $config->putCheckoutEndpoint('Your checkout endpoint'); // optional, but util if VISA change the checkout endpoint
    $config->putRequestHeaders(['Your request headers']);// optional
    
    // create a payable instance
    $payment = VisaPay::fromConfig($config);
    
    // create a visa card
    $visaCard = CardData::make(
        'visa',
        '4111111111111111',
        '12',
        '2025',
        '123',
        'John Doe',
    );
    // create a payment
	try {
		$transaction = (new CheckoutSdk($payment))->makePayment(
			100.00,
			'USD',
			$visaCard,
			'Payment description'
		);
		if ($transaction->successfull()) {
			// add transaction info to your database(id, status, amount, currency, description, user_id, etc.)
		} elseif ($transaction->declined()) {
			// retry payment or do something
		} else {
			// notify user or do something
		}
	} catch (PaymentException $e) {
		// handle exception
		echo $e->getMessage();
	}

测试

要运行测试，您可以使用以下命令

composer test

许可证

MIT 许可证 (MIT)。

致谢

• Faso Dev