Recurring Gifts

curl https://prod-api.raisedonors.com/api/Donor/12345/recurringgifts \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl https://prod-api.raisedonors.com/api/RecurringGift/9876/activities \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST https://prod-api.raisedonors.com/api/Raise/give \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00,
    "paymentMethodId": "tok_abc123",
    "paymentMethodType": "CreditCard",
    "isRecurring": true,
    "frequency": 1,
    "startDate": "2025-02-01",
    "donor": {
      "firstName": "Bruce",
      "lastName": "Wayne",
      "email": "bruce@wayne.example"
    }
  }'

async function changeRecurringAmount(recurringGiftId, newAmount, newProjectAllocation) {
  // 1. Read the current state
  const current = await fetch(
    `https://prod-api.raisedonors.com/api/RecurringGift/${recurringGiftId}`,
    { headers: { Authorization: `Bearer ${process.env.RAISE_API_TOKEN}` } }
  ).then((r) => r.json());

  // 2. Apply the changes
  const updated = {
    ...current,
    amount: newAmount,
    projectAllocation: newProjectAllocation,
  };

  // 3. Write back
  const response = await fetch(
    `https://prod-api.raisedonors.com/api/RecurringGift/${recurringGiftId}`,
    {
      method: 'PUT',
      headers: {
        Authorization: `Bearer ${process.env.RAISE_API_TOKEN}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(updated),
    }
  );
  return response.json();
}

curl -X PUT https://prod-api.raisedonors.com/api/RecurringGift/9876/cancel \
  -H "Authorization: Bearer YOUR_API_TOKEN"

async function findFailedSchedules() {
  const response = await fetch(
    'https://prod-api.raisedonors.com/api/RecurringGift/query',
    {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.RAISE_API_TOKEN}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        skip: 0,
        take: 1000,
        groups: [
          {
            conditions: [
              // Discover the right parameter name and operator via QueryOptions
              { parameter: 'hasPaymentFailed', operator: 0 /* equals */, value: 'true' },
            ],
          },
        ],
      }),
    }
  );
  return (await response.json()).items;
}

async function findSchedulesExpiringSoon(monthsAhead = 2) {
  const allSchedules = await listAllRecurringGifts(); // paginated read
  const now = new Date();
  const cutoff = new Date(now.getFullYear(), now.getMonth() + monthsAhead, 1);

  return allSchedules.filter((s) => {
    if (!s.expMonthAndYear) return false;
    // Parse "MM/YYYY" or similar — confirm format against live API
    const [month, year] = s.expMonthAndYear.split('/').map(Number);
    const expDate = new Date(year, month - 1, 1);
    return expDate < cutoff;
  });
}