README

注意！这是一个工作进展中的库。

SwissBankPayment 是一个 PHP 库，用于生成瑞士 pain.001 XML 消息（符合 ISO-20022 标准）。

安装

只需安装 Composer 并在您的项目目录中运行 composer require mxgma/swiss-bank-payment。

使用

为了更好地理解消息的结构，请查看以下提到的资源。以下示例展示了如何创建包含两个交易的消息

<?php

require_once __DIR__.'/vendor/autoload.php';

use Mxgma\SwissBankPayment\BIC;
use Mxgma\SwissBankPayment\IBAN;
use Mxgma\SwissBankPayment\Message\CustomerCreditTransfer;
use Mxgma\SwissBankPayment\Money;
use Mxgma\SwissBankPayment\PaymentInformation\PaymentInformation;
use Mxgma\SwissBankPayment\PostalAccount;
use Mxgma\SwissBankPayment\StructuredPostalAddress;
use Mxgma\SwissBankPayment\TransactionInformation\BankCreditTransfer;
use Mxgma\SwissBankPayment\TransactionInformation\IS1CreditTransfer;
use Mxgma\SwissBankPayment\UnstructuredPostalAddress;

$transaction1 = new BankCreditTransfer(
    'instr-001',
    'e2e-001',
    new Money\CHF(130000), // CHF 1300.00
    'Muster Transport AG',
    new StructuredPostalAddress('Wiesenweg', '14b', '8058', 'Zürich-Flughafen'),
    new IBAN('CH51 0022 5225 9529 1301 C'),
    new BIC('UBSWCHZH80A')
);

$transaction2 = new IS1CreditTransfer(
    'instr-002',
    'e2e-002',
    new Money\CHF(30000), // CHF 300.00
    'Finanzverwaltung Stadt Musterhausen',
    UnstructuredPostalAddress::sanitize('Altstadt 1a', '4998 Musterhausen'),
    new PostalAccount('80-151-4')
);

$payment = new PaymentInformation(
    'payment-001',
    'InnoMuster AG',
    new BIC('ZKBKCHZZ80A'),
    new IBAN('CH6600700110000204481')
);
$payment->addTransaction($transaction1);
$payment->addTransaction($transaction2);

$message = new CustomerCreditTransfer('message-001', 'InnoMuster AG');
$message->addPayment($payment);

echo $message->asXml();

提示：查看 Mxgma\SwissBankPayment\Tests\Message\CustomerCreditTransferTest 以了解所有支付类型的实际应用。

注意事项

• 并非所有业务规则和建议都得到执行，请参阅文档并与您的银行合作 验证生成的交易文件。
• 目前不支持支票转账（详细信息请参阅实施指南的第 2.2 节）
• 整个项目仍在开发中，因此可能会出现 BC 断裂。如果您需要稳定的代码库，请与我联系。

贡献

如果您想亲自动手，太好了！以下是几个步骤/指南

• 将该仓库进行分支
• 添加您的更改以及对这些更改的测试（在 tests/ 中）。
• 请尽可能遵守现有的代码风格。如有疑问，请遵循 PSR-2。
• 向我发送拉取请求！

如果您不想走这一步，但仍然发现了一些错误或缺失的内容，请让我知道，或者 打开一个新的问题报告，以便我可以或其他人可以处理。

进一步资源

• www.iso-payments.ch 关于瑞士关于 ISO 20022 建议的一般网站
• 瑞士客户-银行消息业务规则
• 瑞士 pain.001 和 pain.002 消息的实施指南
• SIX 验证门户
• PostFinance 验证门户