Portal Sessions API

// 推薦：使用 Recur Server SDK
import { Recur } from 'recur-tw/server';

const recur = new Recur(process.env.RECUR_SECRET_KEY!);

// 方式一：使用客戶 ID
const session = await recur.portal.sessions.create({
  customer: 'cus_xxxxx',
  returnUrl: 'https://your-site.com/account',
});

// 方式二：使用 email
const session = await recur.portal.sessions.create({
  email: 'customer@example.com',
  returnUrl: 'https://your-site.com/account',
});

// 方式三：使用外部 ID（您系統中的用戶 ID）
const session = await recur.portal.sessions.create({
  externalId: 'user_123',
  returnUrl: 'https://your-site.com/account',
});

// 導向客戶
redirect(session.url);

// app/api/portal/create/route.ts
import { NextRequest, NextResponse } from 'next/server';

export async function POST(request: NextRequest) {
  // 可以接收 customer_id、email 或 external_id
  const { customer_id, email, external_id } = await request.json();

  const response = await fetch('https://api.recur.tw/v1/portal/sessions', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.RECUR_SECRET_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      // 提供至少其中一個識別參數
      ...(customer_id && { customer_id }),
      ...(email && { email }),
      ...(external_id && { external_id }),
      return_url: `${process.env.NEXT_PUBLIC_URL}/account`,
    }),
  });

  const data = await response.json();

  if (!response.ok) {
    return NextResponse.json({ error: data.error }, { status: response.status });
  }

  return NextResponse.json({ url: data.url });
}

import requests
import os

def create_portal_session(
    customer_id: str = None,
    email: str = None,
    external_id: str = None
) -> dict:
    """
    建立 Portal Session
    至少需要提供 customer_id、email 或 external_id 其中之一
    """
    body = {
        'return_url': f'{os.environ["APP_URL"]}/account',
    }

    # 根據提供的參數選擇識別方式
    if customer_id:
        body['customer_id'] = customer_id
    elif external_id:
        body['external_id'] = external_id
    elif email:
        body['email'] = email
    else:
        raise ValueError('至少需要提供 customer_id、email 或 external_id')

    response = requests.post(
        'https://api.recur.tw/v1/portal/sessions',
        headers={
            'Authorization': f'Bearer {os.environ["RECUR_SECRET_KEY"]}',
            'Content-Type': 'application/json',
        },
        json=body
    )

    response.raise_for_status()
    return response.json()

# 使用方式
session = create_portal_session(customer_id='cus_xxxxx')
session = create_portal_session(email='customer@example.com')
session = create_portal_session(external_id='user_123')
print(f'Portal URL: {session["url"]}')

# 使用客戶 ID
curl -X POST "https://api.recur.tw/v1/portal/sessions" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_xxxxx",
    "return_url": "https://your-site.com/account"
  }'

# 使用 email
curl -X POST "https://api.recur.tw/v1/portal/sessions" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "return_url": "https://your-site.com/account"
  }'

# 使用外部 ID
curl -X POST "https://api.recur.tw/v1/portal/sessions" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "user_123",
    "return_url": "https://your-site.com/account"
  }'