emanueledona/unicredit-api

dev-master 2017-05-13 09:41 UTC

This package is not auto-updated.

Last update: 2024-09-28 19:47:34 UTC


README

Unicredit API (开发版)

用于将电子商务连接到意大利UniCredit支付服务的库。

基于UniCredit的PHP库,转换为PSR-4格式并包装。

安装

使用 composer require "emanueledona/unicredit-api:dev-master" 通过composer安装最新版本

UniCredit测试参数

用法

使用 use emanueledona\unicreditApi\UnicreditApi; 导入库。

创建对象 $unicredit = new UnicreditApi(); .

调用INIT

$redirect = $unicredit->init($args);

此函数调用IgfsCgInit类,并执行授权初始化(IgfsCgInit::execute())。

$args 参数是一个元素数组

  • 'serverURL' => 'https://testeps.netswgroup.it/UNI_CG_SERVICES/services',
  • 'timeout' => 15000,
  • 'tid' => 'UNI_ECOM',
  • 'kSig' => 'UNI_TESTKEY',
  • 'trType' => 'AUTH',
  • 'currencyCode' => 'EUR',
  • 'langID' => 'IT',
  • 'shopUserRef' => ##CLIENT_EMAIL##,
  • 'shopID' => ##ORDER_ID##,
  • 'amount' => ##TOTAL_AMOUNT##, // 这必须不带小数,例如:199.99 => (199.99*100) = 19999
  • 'notifyURL' => ##URL##, // 验证交易执行正确的URL
  • 'errorURL' => ##URL##, // 处理错误的URL

该函数返回一个URL

  • 如果一切正常,则URL将重定向到UniCredit支付系统
  • 如果有问题,则URL将重定向到包含错误信息的 errorURL

支付ID在哪里?

paymentID 由函数 $unicredit->getPaymentID() 返回,如果没有支付ID,此函数将返回NULL。

此值很重要,此 必须 存储在您的系统中以确保支付验证和验证。

调用VERIFY

$response = $unicredit->verify('your_paymentID',$args);

此函数使用 IgfsCgVerify::execute() 方法验证支付。

要检查支付是否正确,需要 paymentID 和一些配置参数

该函数返回一个数组

  • 在成功的情况下

    • 'status' => 'OK',
    • 'rc' => $IgfsCgVerify->rc,
    • 'tranID' => $IgfsCgVerify->tranID,
    • 'enrStatus' => $IgfsCgVerify->enrStatus,
    • 'authStatus' => $IgfsCgVerify->authStatus,
  • 在出现错误的情况下

    • 'status' => 'KO',
    • 'rc' => $IgfsCgVerify->rc,
    • 'errorDesc' => $IgfsCgVerify->errorDesc,