README

Paytrail 支付 API

更多信息，请访问 https://github.com/paytrail/api-documentation/issues.

安装 & 使用

要求

PHP 7.4 及以上版本。也应与 PHP 8.0 兼容。

Composer

要通过 Composer 安装绑定，请将以下内容添加到 composer.json

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/tuutti/php-paytrail-payments-api.git"
    }
  ],
  "require": {
    "tuutti/php-paytrail-payments-api": "*@dev"
  }
}

然后运行 composer install

手动安装

下载文件并包含 autoload.php

<?php
require_once('/path/to/php-paytrail-payment-api/vendor/autoload.php');

入门

请按照安装过程进行操作，然后运行以下命令

<?php
require_once(__DIR__ . '/vendor/autoload.php');




$apiInstance = new Paytrail\Payment\Api\PaymentReportsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client()
);
$payment_report_request = new \Paytrail\Payment\Model\PaymentReportRequest(); // \Paytrail\Payment\Model\PaymentReportRequest | Payment body payload
$checkout_account = 375917; // int | Merchant ID
$checkout_algorithm = sha512; // string | HMAC algorithm
$checkout_method = POST; // string | HTTP method of the request
$checkout_timestamp = 2018-08-08T10:10:59Z; // \DateTime | Current timestamp in ISO 8601 format
$signature = 'signature_example'; // string | HMAC signature calculated over the request headers and payload

try {
    $result = $apiInstance->requestPaymentReport($payment_report_request, $checkout_account, $checkout_algorithm, $checkout_method, $checkout_timestamp, $signature);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling PaymentReportsApi->requestPaymentReport: ', $e->getMessage(), PHP_EOL;
}

API 端点

所有 URI 都相对于 https://services.paytrail.com

类	方法	HTTP 请求	描述
PaymentReportsApi	requestPaymentReport	POST /payments/report	请求支付报告
PaymentReportsApi	requestPaymentReportBySettlementId	POST /settlements/{settlementId}/payments/report	请求给定结算中包含的支付报告
PaymentsApi	activateInvoiceByTransactionId	POST /payments/{transactionId}/activate-invoice	激活发票
PaymentsApi	createPayment	POST /payments	创建新的开放支付
PaymentsApi	getGroupedPaymentProviders	GET /merchants/grouped-payment-providers	列出分组商户支付方式
PaymentsApi	getPaymentByTransactionId	GET /payments/{transactionId}	通过结账交易 ID 获取支付
PaymentsApi	getPaymentProviders	GET /merchants/payment-providers	列出商户支付方式
PaymentsApi	refundPaymentByTransactionId	POST /payments/{transactionId}/refund	退款
ProvidersApi	getGroupedPaymentProviders	GET /merchants/grouped-payment-providers	列出分组商户支付方式
ProvidersApi	getPaymentProviders	GET /merchants/payment-providers	列出商户支付方式
SettlementsApi	listSettlementIds	GET /settlements	列出结算 ID
TokenPaymentsApi	addCardForm	POST /tokenization/addcard-form	请求重定向到卡片添加表单
TokenPaymentsApi	requestTokenForTokenizationId	POST /tokenization/{checkout-tokenization-id}	请求给定 tokenization ID 的卡片令牌
TokenPaymentsApi	tokenCitAuthorizationHold	POST /payments/token/cit/authorization-hold	请求在令牌上对客户发起的交易进行授权挂起
TokenPaymentsApi	tokenCitCharge	POST /payments/token/cit/charge	请求在令牌上对客户发起的交易进行收费
TokenPaymentsApi	tokenCommit	POST /payments/{transactionId}/token/commit	请求提交（收费）先前创建的授权挂起
TokenPaymentsApi	tokenMitAuthorizationHold	POST /payments/token/mit/authorization-hold	请求商户发起的交易授权挂起令牌
TokenPaymentsApi	tokenMitCharge	POST /payments/token/mit/charge	请求对令牌进行商户发起的交易充值
TokenPaymentsApi	tokenRevert	POST /payments/{transactionId}/token/revert	撤销（删除）之前创建的授权挂起令牌

模型

授权

所有端点都不需要授权。

测试

要运行测试，使用

composer install
vendor/bin/phpunit

作者

关于此包

此PHP包是由OpenAPI Generator项目自动生成的

API版本：2.0.0
构建包：org.openapitools.codegen.languages.PhpClientCodegen

tuutti / php-paytrail-payment-api

维护者

详细信息