性能 / 性能SDK
v3.1.0
2024-09-25 11:53 UTC
Requires
- php: ^8.1
- brick/date-time: ^0.7.0
- guzzlehttp/guzzle: ^7.0
- phpdocumentor/type-resolver: ^1.8
- speakeasy/serializer: ^3.40.0
Requires (Dev)
- laravel/pint: ^1.15
- phpstan/phpstan: ^1.9
- phpunit/phpunit: ^10
- rector/rector: ^0.18.13
- roave/security-advisories: dev-latest
- dev-main
- v3.1.0
- v3.0.0
- v2.4.4
- v2.4.3
- v2.3.2
- v2.2.5
- v2.2.2
- v2.1.2
- v2.1.1
- v2.1.0
- v2.0.6
- v2.0.5
- v2.0.4
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0-rc.15
- v2.0.0-rc.14
- v2.0.0-rc.13
- v2.0.0-rc.12
- v2.0.0-rc.11
- v2.0.0-rc.10
- v2.0.0-rc.9
- v2.0.0-rc.8
- v2.0.0-rc.7
- v2.0.0-rc.4
- v2.0.0-rc.3
- v2.0.0-rc.2
- v2.0.0-rc.1
- v2.0.0-beta.16
- v2.0.0-beta.15
- v2.0.0-beta.14
- v2.0.0-beta.13
- v2.0.0-beta.12
- v2.0.0-beta.11
- v2.0.0-beta.10
- v2.0.0-beta.9
- v2.0.0-beta.8
- v2.0.0-beta.6
- v2.0.0-beta.5
- v2.0.0-beta.4
- v2.0.0-beta.2
- v2.0.0-beta.1
- v1.0.202307124
- v1.0.20230915
- v1.0.20230725
- v1.0.20230724
- v1.0.20230718.1
- v1.0.20230718
- v1.0.20230714
- v1.0.20230713
- v1.0.20230710
- v1.0.20230627
- v1.0.20230623-beta.1
- v1.0.20230301
- v1.0.20230228
- v1.0.20230227
- v1.0.0-rc.1
- dev-speakeasy-sdk-regen-1727265025
- dev-speakeasy-sdk-regen-1726618004
- dev-feat/upgrade-speakeasy
- dev-speakeasy-sdk-regen-1710763459
- dev-release/v2.0.0-rc.15
- dev-release/v2.0.0-rc.14
- dev-release/v2.0.0-rc.13
- dev-release/v2.0.0-rc.12
- dev-release/v2.0.0-rc.11
- dev-release/v2.0.0-rc.10
- dev-release/v2.0.0-rc.9
- dev-release/v2.0.0-rc.8
- dev-release/v2.0.0-rc.7
- dev-release/v2.0.0-rc.4
- dev-release/v2.0.0-rc.3
- dev-release/v2.0.0-rc.2
- dev-release/v2.0.0-rc.1
- dev-release/v2.0.0-beta.16
- dev-release/v2.0.0-beta.15
- dev-release/v2.0.0-beta.14
- dev-release/v2.0.0-beta.13
- dev-release/v2.0.0-beta.12
- dev-release/v2.0.0-beta.11
- dev-release/v2.0.0-beta.10
- dev-release/v2.0.0-beta.9
- dev-release/v2.0.0-beta.8
- dev-release/v2.0.0-beta.6
- dev-release/v2.0.0-beta.5
- dev-release/v2.0.0-beta.4
- dev-release/v2.0.0-beta.2
- dev-release/v2.0.0-beta.1
- dev-release/v1.0.3
- dev-beta
- dev-release/v1.0.20230301
- dev-release/v1.0.20230228
- dev-release/v1.0.20230227
- dev-21/merge
- dev-20/merge
- dev-18/merge
- dev-feat/wallets
- dev-feat/add_search_in_monorepo
- dev-release/v1.0.0-rc.5
- dev-release/v1.0.0-rc.4
- dev-feat/update-webhooks
- dev-release/v1.0.0-rc.3
- dev-release/v1.0.0-rc.2
- dev-feat/num-1287-stack-update-sdk-with-wallet-component
- dev-feat/feature-branches
- dev-release/v1.0.0-beta.3
This package is auto-updated.
Last update: 2024-09-25 11:55:30 UTC
README
🏗 欢迎使用您的新SDK! 🏗
它已成功基于您的OpenAPI规范生成。但是,它尚未准备好用于生产。以下是一些下一步操作
- 🛠 通过 自定义它 使您的SDK感觉手工制作
- ♻️ 通过使用 Speakeasy CLI 在本地迭代快速优化您的SDK
- 🎁 通过 配置自动发布 将您的SDK发布到包管理器
- ✨ 当准备好用于生产时,请从README中删除此部分
摘要
性能栈API:独特的支付流程的开放、模块化基础
介绍
此API使用 OpenAPI格式 进行文档化。
身份验证
性能栈提供一种身份验证方式
- OAuth2 OAuth2 - 一个开放协议,允许通过简单和标准的方法从Web、移动和桌面应用程序进行安全的授权。
目录
SDK安装
SDK依赖于 Composer 来管理其依赖项。
要安装SDK并将其添加到现有 composer.json
文件中的依赖项
composer require "formance/formance-sdk"
SDK示例用法
示例
declare(strict_types=1); require 'vendor/autoload.php'; use formance\stack; use formance\stack\Models\Operations; $sdk = stack\SDK::builder()->build(); try { $requestSecurity = new Operations\GetVersionsSecurity( authorization: "<YOUR_AUTHORIZATION_HERE>", ); $response = $sdk->getVersions($requestSecurity); if ($response->getVersionsResponse !== null) { // handle response } } catch (Throwable $e) { // handle exception }
可用资源和操作
可用方法
Auth
账本
编排
支付
对账
SDK
- getVersions - 显示堆栈版本信息
SDKOrchestrationV1
- cancelEvent - 取消正在运行的流程
- createTrigger - 创建触发器
- createWorkflow - 创建流程
- deleteTrigger - 删除触发器
- deleteWorkflow - 通过id删除流程
- getInstance - 通过id获取流程实例
- getInstanceHistory - 通过id获取流程实例历史记录
- getInstanceStageHistory - 获取流程实例阶段历史记录
- getWorkflow - 通过id获取流程
- listInstances - 列出工作流程的实例
- listTriggers - 列出触发器
- listTriggersOccurrences - 列出触发器发生
- listWorkflows - 列出已注册的工作流程
- orchestrationgetServerInfo - 获取服务器信息
- readTrigger - 读取触发器
- runWorkflow - 运行工作流程
- sendEvent - 向运行中的工作流程发送事件
SDKPaymentsV1
- addAccountToPool - 将账户添加到池中
- connectorsTransfer - 在连接器账户之间转账
- createAccount - 创建账户
- createBankAccount - 在支付系统和PSP上创建银行账户
- createPayment - 创建支付
- createPool - 创建池
- createTransferInitiation - 创建转账发起
- deletePool - 删除池
- deleteTransferInitiation - 删除转账发起
- forwardBankAccount - 将银行账户转发到连接器
- getAccountBalances - 获取账户余额
- getBankAccount - 获取Formance上用户创建的银行账户
getConnectorTask- 读取连接器的特定任务 ⚠️ 已弃用- getConnectorTaskV1 - 读取连接器的特定任务
- getPayment - 获取支付
- getPool - 获取池
- getPoolBalances - 获取池余额
- getTransferInitiation - 获取转账发起
- installConnector - 安装连接器
- listAllConnectors - 列出所有已安装的连接器
- listBankAccounts - 列出Formance上用户创建的银行账户
- listConfigsAvailableConnectors - 列出所有可用的连接器的配置
listConnectorTasks- 列出连接器的任务 ⚠️ 已弃用- listConnectorTasksV1 - 列出连接器的任务
- listPayments - 列出支付信息
- listPools - 列出资金池
- listTransferInitiations - 列出转账发起
- paymentsgetAccount - 获取账户信息
- paymentsgetServerInfo - 获取服务器信息
- paymentslistAccounts - 列出账户
readConnectorConfig- 读取连接器的配置 ⚠️ 已弃用- readConnectorConfigV1 - 读取连接器的配置
- removeAccountFromPool - 从资金池中移除账户
resetConnector- 重置连接器 ⚠️ 已弃用- resetConnectorV1 - 重置连接器
- retryTransferInitiation - 重试失败的转账发起
- reverseTransferInitiation - 反转转账发起
- udpateTransferInitiationStatus - 更新转账发起的状态
uninstallConnector- 卸载连接器 ⚠️ 已弃用- uninstallConnectorV1 - 卸载连接器
- updateBankAccountMetadata - 更新银行账户元数据
- updateConnectorConfigV1 - 更新连接器的配置
- updateMetadata - 更新元数据
SDKReconciliationV1
- createPolicy - 创建策略
- deletePolicy - 删除策略
- getPolicy - 获取策略
- getReconciliation - 获取对账
- listPolicies - 列出策略
- listReconciliations - 列出对账
- reconcile - 使用策略进行对账
- reconciliationgetServerInfo - 获取服务器信息
SDKSearchV1
- search - search.v1
- searchgetServerInfo - 获取服务器信息
SDKV1
- createTransactions - 向账本创建一批新交易
- addMetadataOnTransaction - 通过ID设置交易的元数据
- addMetadataToAccount - 向账户添加元数据
- countAccounts - 统计账本中的账户数量
- countTransactions - 统计账本中的交易数量
- createTransaction - 向账本创建新交易
- getAccount - 通过地址获取账户
- getBalances - 获取账本账户的余额
- getBalancesAggregated - 获取所选账户的汇总余额
- getInfo - 显示服务器信息
- getLedgerInfo - 获取账本信息
- getMapping - 获取账本映射
- getTransaction - 通过ID从账本获取交易
- listAccounts - 列出账本中的账户
- listLogs - 列出账本的日志
- listTransactions - 列出账本中的交易
- readStats - 从账本获取统计信息
- revertTransaction - 通过ID撤销账本交易
runScript- 执行Numscript ⚠️ 已弃用- updateMapping - 更新账本映射
SDKV2
- cancelEvent - 取消正在运行的流程
- createTrigger - 创建触发器
- createWorkflow - 创建工作流
- deleteTrigger - 删除触发器
- deleteWorkflow - 通过ID删除流程
- getInstance - 通过ID获取工作流实例
- getInstanceHistory - 通过ID获取工作流实例历史
- getInstanceStageHistory - 获取工作流实例阶段历史
- getServerInfo - 获取服务器信息
- getWorkflow - 通过ID获取流程
- listInstances - 列出工作流的实例
- listTriggers - 列出触发器
- listTriggersOccurrences - 列出触发器发生次数
- listWorkflows - 列出已注册的工作流
- readTrigger - 读取触发器
- runWorkflow - 运行工作流
- sendEvent - 向正在运行的工作流发送事件
- testTrigger - 测试触发器
SDKWalletsV1
- confirmHold - 确认保留
- createBalance - 创建余额
- createWallet - 创建新钱包
- creditWallet - 信用钱包
- debitWallet - 借记钱包
- getBalance - 获取详细余额
- getHold - 获取保留
- getHolds - 获取钱包的所有保留
- 获取交易
- getWallet - 获取钱包
- getWalletSummary - 获取钱包摘要
- listBalances - 列出钱包余额
- listWallets - 列出所有钱包
- updateWallet - 更新钱包
- voidHold - 取消保留
- walletsgetServerInfo - 获取服务器信息
SDKWebhooksV1
- activateConfig - 激活一个配置
- changeConfigSecret - 更改配置的签名密钥
- deactivateConfig - 禁用一个配置
- deleteConfig - 删除一个配置
- getManyConfigs - 获取多个配置
- insertConfig - 插入一个新的配置
- testConfig - 测试一个配置
搜索
V1
- createClient - 创建客户端
- createSecret - 向客户端添加密钥
- deleteClient - 删除客户端
- deleteSecret - 从客户端删除密钥
- getOIDCWellKnowns - 获取OpenID连接已知信息
- getServerInfo - 获取服务器信息
- listClients - 列出客户端
- listUsers - 列出用户
- readClient - 读取客户端
- readUser - 读取用户
- updateClient - 更新客户端
V2
- addMetadataOnTransaction - 通过ID设置交易的元数据
- addMetadataToAccount - 向账户添加元数据
- countAccounts - 计算账本中的账户数量
- countTransactions - 计算账本中的交易数量
- createBulk - 批量请求
- createLedger - 创建账本
- createTransaction - 向账本创建新交易
- deleteAccountMetadata - 通过键删除元数据
- deleteLedgerMetadata - 通过键删除账本元数据
- deleteTransactionMetadata - 通过键删除交易元数据
- exportLogs - 导出日志
- getAccount - 通过地址获取账户
- getBalancesAggregated - 获取选定账户的聚合余额
- getInfo - 显示服务器信息
- getLedger - 获取账本
- getLedgerInfo - 获取账本信息
- getTransaction - 通过ID从账本获取交易
- getVolumesWithBalances - 获取具有余额的卷列表
- importLogs
- listAccounts - 列出账本中的账户
- listLedgers - 列出账本
- listLogs - 列出账本的日志
- listTransactions - 列出账本中的交易
- readStats - 从账本获取统计数据
- revertTransaction - 通过ID撤销账本交易
- updateLedgerMetadata - 更新账本元数据
钱包
Webhooks
服务器选择
服务器选择
按索引选择服务器
您可以通过在初始化SDK客户端实例时传递一个服务器索引到server_idx: int
可选参数来全局覆盖默认服务器。然后所选服务器将在使用它的操作中用作默认服务器。此表列出了与可用服务器关联的索引
变量
上述一些服务器选项包含变量。如果您想设置这些变量的值,则在初始化SDK客户端实例时可以使用以下可选参数
环境: stack\ServerEnvironment
组织: 字符串
按客户端覆盖服务器URL
默认服务器也可以通过在初始化SDK客户端实例时传递一个URL到server_url: str
可选参数来全局覆盖。例如
开发
成熟度
此SDK处于测试版,版本之间可能存在重大更改而无需进行主要版本更新。因此,我们建议将使用绑定到特定包版本。这样,您可以在不进行破坏性更改的情况下每次安装相同版本,除非您有意寻找最新版本。
贡献
虽然我们重视对SDK的开放源代码贡献,但这个库是程序生成的。请随时提交一个PR或Github问题作为概念证明,我们将尽力将其包含在未来版本中!