missael-anda/laravel-mercado-pago

Laravel 的 MercadoPago API

v0.8.9-alpha 2024-08-20 20:23 UTC

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_IDMERCADO_PAGO_ACCESS_TOKENMERCADO_PAGO_PUBLIC_KEY

如果您想使用 MercadoPago 应用管理其他用户的账户,则需要提供 MERCADO_PAGO_APP_IDMERCADO_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 事件,其中包含 codestate,您可以使用 MercadoPago::oauth()->createAccessToken() 函数使用它们生成访问令牌。您可以使用 refresh_tokenMercadoPago::oauth()->refreshAccessToken() 来刷新令牌。

Webhooks

Webhooks 会自动处理和验证,这将触发 WebhookReceived 事件以及根据事件本身触发的 PointIntegrationEventWebhookEvent

如果您想禁用 webhook 或签名验证,可以在配置文件中这样做。

缺少的功能

  • CheckoutPro
  • CheckoutApi
  • CheckoutBricks
  • PaymentLinks
  • Subscriptions
  • WalletConnect
  • SplitPayments

许可证

本项目采用 MIT 许可证