README

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

安装

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

使用方法

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

<?php

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

use Z38\SwissPayment\BIC;
use Z38\SwissPayment\IBAN;
use Z38\SwissPayment\Message\CustomerCreditTransfer;
use Z38\SwissPayment\Money;
use Z38\SwissPayment\PaymentInformation\PaymentInformation;
use Z38\SwissPayment\PostalAccount;
use Z38\SwissPayment\StructuredPostalAddress;
use Z38\SwissPayment\TransactionInformation\BankCreditTransfer;
use Z38\SwissPayment\TransactionInformation\IS1CreditTransfer;
use Z38\SwissPayment\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();

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

注意事项

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

贡献

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

• 从本存储库派生
• 添加您的更改及其测试（在 tests/ 中）。
• 请尽可能遵守现有的代码风格。如有疑问，请遵循 PSR-2。
• 向我发送拉取请求！

如果您不想通过所有这些步骤，但仍然发现了一些错误或缺失之处，请告诉我，或创建一个新的问题报告，以便我可以处理或其他人可以处理。

进一步资源

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