missael-anda / laravel-mercado-pago
Laravel 的 MercadoPago API
Requires
- illuminate/support: ^10.0|^11.0
- mercadopago/dx-php: ^3.0
This package is auto-updated.
Last update: 2024-09-20 20:26:27 UTC
README
提供 Laravel 所需所有商品功能的 MercadoPago API。
安装
composer require missael-anda/laravel-mercado-pago
配置
如果您想简单地使用单个默认租户,则需要定义 MERCADO_PAGO_USER_ID
、MERCADO_PAGO_ACCESS_TOKEN
和 MERCADO_PAGO_PUBLIC_KEY
。
如果您想使用 MercadoPago 应用管理其他用户的账户,则需要提供 MERCADO_PAGO_APP_ID
和 MERCADO_PAGO_APP_SECRET
。
您可以使用以下命令发布完整的配置文件
php artisan vendor:publish --provider="MissaelAnda\MercadoPago\MercadoPagoServiceProvider" --tag=config
使用
您可以通过 MercadoPago::default()
方法获取默认租户,或者直接访问所有功能,如果您想提供多个租户,则需要实现 MercadoPagoTenant
接口并将其传递给 MercadoPago::tenant($tenant)
函数或服务。
服务
-
oauth()
(不需要租户) -
stores()
-
pos()
-
points()
-
payments()
-
me()
OAuth
如果您想管理多个租户,您必须实现授权流程,您需要在配置中提供 OAuth 重定向 URL,您还可以开启 PKCE。
您可以使用 MercadoPago::oauth()->generateOAuthLink()
创建客户端的授权链接。当用户成功授权后,将重定向到配置的 URL,这将触发 OAuthCallbackReceived
事件,其中包含 code
和 state
,您可以使用 MercadoPago::oauth()->createAccessToken()
函数使用它们生成访问令牌。您可以使用 refresh_token
和 MercadoPago::oauth()->refreshAccessToken()
来刷新令牌。
Webhooks
Webhooks 会自动处理和验证,这将触发 WebhookReceived
事件以及根据事件本身触发的 PointIntegrationEvent
或 WebhookEvent
。
如果您想禁用 webhook 或签名验证,可以在配置文件中这样做。
缺少的功能
- CheckoutPro
- CheckoutApi
- CheckoutBricks
- PaymentLinks
- Subscriptions
- WalletConnect
- SplitPayments
许可证
本项目采用 MIT 许可证。