# Initial payment for recurring payments

PSPs can require or optionally support an initial payment when setting up a new recurring payment. Typically used with credit cards, the initial payment may be, for example, a nominal fee required for authorization or the first full collection of a new recurring payment.

The FinDock Payment API tells you what is allowed with the payment method setting `InitialPaymentOnRecurring`, returned with the `GET PaymentMethods` endpoint. The possible options are:

* Required: The recurring payment setup *must* include an initial payment.
* Optional: The recurring payment setup *may* include an initial payment.
* No: The recurring payment setup *must not* include an initial payment.


With Giving Pages, you can use the toggle in the payment methods configuration to enable initial payment. The initial payment amount is automatically set to be equal to the amount of the recurring payment.

Toggle for initial payment on recurring in Pages configuration
For custom integrations, if an initial payment is required or optional, you use the `OneTime` block to set the first payment, as in the example below.


```json
    {
      "Recurring": {
        "Amount": 10,
        "Frequency": "Monthly",
        "StartDate": "2025-01-01",
        "EndDate": "2026-01-01"
      },
      "OneTime": {
        "Amount": 10
      },
      "SuccessURL": "https://www.example.com/success",
      "FailureURL": "https://www.example.com/failure",
      "Payer": {
        "Contact": {
          "SalesforceFields": {
            "FirstName": "First",
            "LastName": "Last",
            "Email": "first.last@email.address",
          }
        }
      },
      "PaymentMethod": {
        "Name": "CreditCard"
      }
    }
```

`RecurringRequiresInitialPayment` setting is deprecated in favor of `InitialPaymentOnRecurring`.