README

SwissPayment是一个PHP库，用于生成瑞士pain.001 XML消息（符合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中断。如果您需要一个稳定的代码库，请与我联系。

贡献

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

• 将此存储库Fork
• 添加您的更改和这些更改的测试（在tests/中）。
• 请记住尽可能坚持现有的代码风格。如有疑问，请遵循PSR-2。
• 向我发送拉取请求！

如果您不想进行所有这些操作，但仍然发现了一些错误或遗漏，请告诉我，或者创建一个新的问题报告，以便我可以或其他人可以处理它。

进一步资源

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