贝宝

获取你的 PayPal 凭证

要与 PayPal 集成，你需要通过在 PayPal 开发者门户 创建应用来获取 API 凭证。

按以下步骤操作：

1. 在 PayPal 开发者门户创建一个账户
2. 创建一个新应用，官方文档
3. 在“其他功能”下配置使用 PayPal 登录
4. 设置你的返回网址（重定向网址）
5. 配置用户信息权限
6. 请记下你的客户端 ID 和客户端密钥

确保在你的应用设置中配置“使用 PayPal 登录”:

1. 前往开发者控制台中的应用
2. 在“其他功能”下，勾选“使用 PayPal 登录”
3. 点击“高级设置”
4. 输入你的返回网址
5. 选择你想要访问的用户信息（电子邮件、名称等）
6. 请输入隐私政策和用户协议的链接

配置提供程序

要配置提供程序，你需要导入该提供程序并将其传递给身份验证实例的 socialProviders 选项。

import { betterAuth } from "better-auth"

export const auth = betterAuth({
    socialProviders: {
        paypal: { 
            clientId: process.env.PAYPAL_CLIENT_ID as string, 
            clientSecret: process.env.PAYPAL_CLIENT_SECRET as string, 
            environment: "sandbox", // or "live" for production //,
        }, 
    },
})

Options

The PayPal provider accepts the following options:

• environment：'sandbox' | 'live' - 要使用的 PayPal 环境（默认：'sandbox'）
• requestShippingAddress：boolean - 是否请求送货地址信息（默认值：false）

export const auth = betterAuth({
    socialProviders: {
        paypal: {
            clientId: process.env.PAYPAL_CLIENT_ID as string,
            clientSecret: process.env.PAYPAL_CLIENT_SECRET as string,
            environment: "live", // Use "live" for production
            requestShippingAddress: true, // Request address info
        },
    },
})

Sign In with PayPal

To sign in with PayPal, you can use the signIn.social function provided by the client. The signIn function takes an object with the following properties:

• provider：要使用的提供者。应设置为 paypal。

import { createAuthClient } from "better-auth/client"
const authClient =  createAuthClient()

const signIn = async () => {
    const data = await authClient.signIn.social({
        provider: "paypal"
    })
}

Additional Options:

• environment：要使用的 PayPal 环境。
  • 默认："sandbox"
  • 选项："sandbox" | "live"
• requestShippingAddress：是否需要请求收货地址信息。
  • 默认：false
• scope：请求的附加权限范围（与默认权限组合使用）。
  • 默认：在 PayPal 开发者控制台中配置
  • 注意：PayPal 不使用传统的 OAuth2 范围——权限是在仪表板中设置的。如需更多详情，请参阅 范围参考
• mapProfileToUser：将 PayPal 配置文件数据映射到用户对象的自定义函数。
• getUserInfo：用于获取用户信息的自定义函数。更多详情请参阅 用户参考
• verifyIdToken：自定义 ID 令牌验证函数。