target365 / sdk
Target365 SDK
Requires
- php: >=7.1
- guzzlehttp/guzzle: ~7.0
- phpseclib/phpseclib: ~3.0
- phpseclib/phpseclib2_compat: ~1.0
- psr/log: ^1.0 || ^3.0
Requires (Dev)
- incenteev/composer-parameter-handler: ~2.0
- monolog/monolog: ^1.23
- phpunit/phpunit: ^7.0
- ramsey/uuid: ^3.8
- symfony/var-dumper: ^4.1
- symfony/yaml: ~4.2
This package is not auto-updated.
Last update: 2024-09-18 10:12:08 UTC
README
Strex AS 是一家挪威支付和 SMS 网关(Strex Connect)服务提供商。Strex 持有电子货币许可证,并每年处理超过 7000 万笔交易。Strex 在挪威拥有超过 4.2 百万客户,由挪威移动网络运营商(Telenor、Telia 和 Ice)拥有。Strex Connect 基于Target365 营销和通信平台。
PHP 的 Target365 SDK
入门
要开始,请点击此处: https://strex.no/strex-connect#Prispakker 并注册您的组织。有关 SDK,请发送电子邮件至 sdk@strex.no,其中包含您的 RSA 公钥(PEM 格式)。您可以使用 openssl 生成 RSA 公钥/私钥对,如下所示
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:1024 -out private.pem
使用 openssl 将其转换为 pk8 格式,这是 PHP 使用的。
openssl pkcs8 -topk8 -inform pem -in private.pem -outform pem -nocrypt -out private.key
私钥文件 private.key
应该看起来像这样
-----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBAML6duyE7hL2XPEH
qiYtyghoj6pO21zGPwSaBKTCg6i3AeJ4Ob6pCnvYQA+rRfw/+aBfT+Rv3LTSmX2i
9bAsLQB0Q3y8zku2NmqE/yoqhb9GAhL3toMasBuJ3ifvUOXTajtGEKy++YkAkRBK
7Wi/bK/IQNZd9nsOtKxz5DXNELbHAgMBAAECgYAj6k8Nsk7IX2kvXOIStkyIz/nm
vS/bHwlsp5JDZzEpWsyWEt9QJ4Mu3N6wBDSYCpDI4cWtpo1ZIZH0epgXI4wGPv2j
a6ilWZywUdhFZw1AUc3qLRoapqIPliimLhxPWmV2OfvbA4LiNvWGsF/qTaqVQ/0V
ebj+JYjJdFQcTjqlwQJBAOpKQ/EyuzDlO7YVPmw0rAfVRfVqTIvzpZ3hGThztcnQ
igI3ftbGSOPUcter3/cX5ENrIGMP6hLsWqSKWECBwK0CQQDVC6mVkrit/VXby2Zp
8epgprGhrUHojNO7ojQQN1Mupr4AHUWr2Y3xJH1uXaOjafBc6uLK7Cri3eLru+iy
Ph/DAkBLG/fgEVV1fWfBHdpfMhucf0DoRmW30CpeDNXbBS1YP6SexU/CZtrjPy55
+b3ZJy2kd2lwmJ9/5YnBiiB0vaQZAkEAuTgPcrOBjfqu94zpd/hTTT3/NtGbeGNe
/UTywJpo3iknDJBmbxaQOfMAfcA5MSw8RXwMOmGCk4RW8Z2Hm9c44wJBAJvIcnMV
6b2G6pizPPjoPhV+eNruWTyFt5ralEmxDpqV3p4TP89KVvaBlkzlT28p1P9vp5bD
J6BLhdOAUfC3CMY=
-----END PRIVATE KEY-----
请注意,当在 PHP 中使用私钥时,必须删除所有换行符,以确保私钥在一行中。
使用以下 openssl 命令提取公钥
openssl rsa -in private.key -pubout -out public.key
然后,您可以发送 public.key
文件给我们。文件应该看起来像这样
-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDC+nbshO4S9lzxB6omLcoIaI+q
Tttcxj8EmgSkwoOotwHieDm+qQp72EAPq0X8P/mgX0/kb9y00pl9ovWwLC0AdEN8
vM5LtjZqhP8qKoW/RgIS97aDGrAbid4n71Dl02o7RhCsvvmJAJEQSu1ov2yvyEDW
XfZ7DrSsc+Q1zRC2xwIDAQAB
-----END PUBLIC KEY-----
有关 SDK 的更多详细信息,我们强烈建议您查看我们的 PHP 用户指南。
Composer
composer require target365/sdk
测试环境
我们的测试环境充当沙箱,尽可能地模拟真实 API。这可以用于在投入生产之前熟悉服务。请注意,模拟并不完美,不应被视为具有 100% 的准确性。
Url: https://test.target365.io/
生产环境
我们的生产环境是隔离的租户环境与共享公共环境的组合。如果您对隔离的租户环境感兴趣,请联系 sdk@strex.no。
Url: https://shared.target365.io/
作者和维护者
Target365 (sdk@strex.no)
问题/错误/疑问
如果您有任何疑问或问题,请随时对此存储库提出问题。
私钥
Target365 PHP SDK 只允许 RSA 私钥。私钥应传递给 \Target365\ApiSdk\ApiClient
构造函数。密钥可以包含 -----BEGIN RSA PRIVATE KEY-----
部分。您必须在使用 PHP SDK 时从私钥中删除所有换行符。
贡献
欢迎新的贡献者加入此项目。如果您有兴趣贡献,请发送电子邮件至 sdk@strex.no。
自动测试
自动测试使用 PHPUnit 框架。以下是运行自动测试的推荐步骤。
- 克隆存储库。
- 更改到存储库目录。
- (可选)使用 vagrant 文件作为
tests/Vagrantfile
- 运行
composer install
。- 运行 composer 将提示您输入一些必要的信息,这些信息将被存储在名为
tests/secrets.yml
的文件中。 - 输入
private_key
时,将密钥作为一行字符串输入,并排除-----BEGIN RSA PRIVATE KEY-----
部分。
- 运行 composer 将提示您输入一些必要的信息,这些信息将被存储在名为
- 运行 PHPUnit。
./vendor/bin/phpunit
许可证
此库采用 MIT 许可证发布。