yellowmelon/targetpay

TargetPay PHP SDK

dev-master 2014-10-26 16:55 UTC

This package is not auto-updated.

Last update: 2024-09-24 07:32:22 UTC


README

使用此(命名空间)SDK,您可以轻松地调用TargetPay,以进行所有提供的支付方式。

要求:PHP 5.3+

安装

  • 将/lib中的文件复制到您的Web服务器上。

使用方法

首先注册自动加载器。如果您的框架已经具有自动加载器,您可能不需要使用此功能。使用到自动加载文件的正确路由

require_once __DIR__.'/../lib/TargetPay/autoload.php';

包含TargetPay命名空间

use \TargetPay as TargetPay;

现在通过调用以下方式开始支付

$startPaymentResult = TargetPay\Transaction::model("Ideal")
    ->rtlo(121455)
    ->amount(1000)
    ->description('Test payment')
    ->returnUrl('http://www.test.nl/success')
    ->cancelUrl('http://www.test.nl/canceled')
    ->reportUrl('http://www.test.nl/report')
    ->bank('0021')
    ->start();	 	

您可以检查结果。在成功的情况下,$startPaymentResult->status将为true。如果未成功,startPaymentResult->status将包含错误消息。

如果一切正常,请重定向到银行

Header ("Location: ".$startPaymentResult->url);

支付后,TargetPay将调用reportUrl,传递事务ID等。有关更多信息,请参阅TargetPay文档。

此报告URL背后的脚本需要检查报告的有效性,从而检查实际支付。

这通过调用(在包含自动加载器和使用声明之后)来完成

		$checkPaymentResult = TargetPay\Transaction::model($method)
		 	->rtlo(121455)
		 	->txid($startPaymentResult->txid)
		 	->test(false)
		 	->check();

$checkPaymentResult中检查结果以获取有关支付的更多信息。最重要的是:$checkPaymentResult = true表示支付成功。将支付结果保存到您的数据库中。

当客户支付时,他们将被重定向到Return URL。如果没有,他们将被重定向到Cancel URL。

支付方式

目前实现了以下支付方式。有关它们的详细信息(如最小/最大金额和特定属性),请参阅/lib/TargetPay/Methods下的类(括号内)

  • iDEAL (Methods_Ideal)
  • Bancontact/Mister Cash (Methods_MisterCash)
  • Sofort Banking,原名DirectEbanking (Methods_Sofort)
  • Paysafecard,原名Wallie (Methods_Paysafecard)
  • Visa/Mastercard (Methods_Creditcard)

备注

  • 上述描述的初始调用略有简化。对于iDEAL,您首先需要要求客户选择他的银行,并通过bank()将其传递。对于Sofort,您指定country(),选项在文档中列出。其他支付方式不需要这些参数。
  • 不要忘记输入您自己的layoutcode。121455只是一个测试码。