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节）
• 该项目仍在开发中，因此可能发生向后不兼容的更改。如果您需要一个稳定的代码库，请与我联系。

贡献

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

• 复制此存储库
• 添加您的更改以及针对这些更改的测试（在 tests/ 中）。
• 请尽可能遵循现有的代码风格。如有疑问，请遵循 PSR-2。
• 向我发送拉取请求！

如果您不想这样做，但仍然发现了一些错误或遗漏，请告诉我，或者可以开一个新的问题报告，以便我可以或其他人可以处理。

更多资源

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