Skip to content
Aller au contenu
Charitips

API reference · Recurring Donations

Update a recurring donation

PATCH/v1/recurring-donations/{recurringDonationId}

Update a recurring donation.

Requires a Bearer access token.

Parameters

This field has no description in the spec.

  • recurringDonationId#stringin pathrequired

Body

UpdateRecurringDonationDto
  • amount#integer (int64)minimum 1

    Donation amount in minor currency unit i.e cents.

  • donorFirstName#string

    First name of the donor. Will be used for email communications.

  • donorLastName#string

    Last name of the donor. Will be used for email communications.

  • donorEmail#string

    Email of the donor. Will be used for email communications.

  • externalId#string

    An optional internal id of your system e.g orderId or customerId. Can be used to link a recurring donation to an entity in your system.

  • uniqueExternalId#string

    Similar to externalId but should be unique across all recurring donations. Can be used to prevent duplicate recurring donations.

  • language#string

    Locale to be used to communicate with the donor. Default to the campaign's language value.

    fren

Response

200 · RecurringDonation

No field is described in the spec.

  • recurringDonationId#stringalways returned

  • type#RecurringDonationTypealways returned

    FREQUENCYMANUAL

  • amountType#RecurringDonationAmountTypealways returned

    FIXED_AMOUNTRATE

  • status#RecurringDonationStatusalways returned

    PENDINGACTIVEPAUSEDCANCELED

  • hasBeenCharged#booleanalways returned

  • feeType#FeeTypealways returned

    EXCLUDEDINCLUDED

  • amount#integer (int64)always returned

  • rate#number

  • baseAmount#integer (int64)

  • withRounding#booleanalways returned

  • frequency#string

  • secret#stringalways returned

  • externalId#string

  • uniqueExternalId#string

  • sendingMode#CampaignSendingModealways returned

    MANUALEMAILPHYSICALSLACKPOSTAL

  • sendingDate#string (date-time)

  • sendingStatus#DonationSendingStatusalways returned

    PENDINGFAILEDDONE

  • lastReminderId#string

  • message#string

  • reminderMessage#string

  • from#string

  • language#Languagealways returned

    fren

  • accountId#stringalways returned

  • campaignId#stringalways returned

  • charityId#string

  • donorId#stringalways returned

  • createdAt#string (date-time)always returned

  • updatedAt#string (date-time)always returned

Errors

  • 400A field is missing, has the wrong type, or is not part of the request schema.

    Every request with a body or query is validated.

    {
      "statusCode": 400,
      "message": [
        "amount must not be less than 1",
        "property foo should not exist"
      ],
      "error": "Bad Request"
    }
  • 401Unauthorized

    Missing, expired or invalid access token.

    {
      "statusCode": 401,
      "message": "Unauthorized"
    }
  • 403Account closed
    {
      "message": "Account closed",
      "code": "ACCOUNT_CLOSED"
    }
  • 403Forbidden

    Your credentials cannot perform this action on this resource. An id from another account answers 404 in the path, 400 in the body or the query.

    {
      "statusCode": 403,
      "message": "Forbidden"
    }
  • 404Not Found

    No resource with this id on your account: the API answers as if it did not exist.

    {
      "statusCode": 404,
      "message": "Not Found"
    }
  • 409Unique constraint failed on uniqueExternalId

    {
      "statusCode": 409,
      "message": "Unique constraint failed on uniqueExternalId"
    }
PATCH /v1/recurring-donations/<recurringDonationId>
curl -X PATCH https://api.sandbox.charitips.com/v1/recurring-donations/<recurringDonationId> \  -H "Authorization: Bearer $CHARITIPS_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "amount": 2000,    "donorFirstName": "<donorFirstName>"  }'
Built from the spec and the API code

Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.