Platform Update – Week 16
This release introduces support for payment agreements as a new concept in RaiseNow. It also adds a new payment method for Swiss QR invoices and extends support for existing direct debit variants — CH-DD Direct Debit, LSV+, and SEPA Direct Debit — to be used in conjunction with payment agreements. This enables capturing customer commitments without necessarily managing payments through RaiseNow.
Highlights in this release:
- New object for payment agreements
- New payment method for Swiss QR
- Processing recurring card payments via PayPal
- Processing cancellations from PayPal
- Setting additional information in custom_id in PayPal
- Supporting recurring PayPal payments on RaiseNow Hub solutions
- Added support for exists queries to the Search API
- TWINT status updates on the RaiseNow status page
- Bugfixes and other improvements
This release enables payment agreements in Tamaro v2.15.0 and on the API but not yet as a view on RaiseNow Hub. This enables capturing donor data and provides much needed testing capabilities for partners. It also provides the basis for our own API integrations for various CRM systems.
Customers will be contacted to coordinate their migration from the legacy RaiseNow Manager to the new RaiseNow Hub. Reach out to RaiseNow support if you wish to expedite switching to payment agreements on Tamaro earlier.
New object for payment agreements
At RaiseNow, a payment agreement means someone agrees to pay a certain amount — either once or on a recurring basis — to another person or organisation. This can be a non-binding promise (like a pledge) or a formal agreement (like a membership fee). It is up to the organisation receiving the money (the payee) to ensure the payment is made — not RaiseNow. However, payees can use RaiseNow tools — like dunning (reminders for missed payments) — to support this process when RaiseNow is used as the payment initiation agent.
New payment method for Swiss QR
A new payment method, ch_qr_reference
, is now available via the API and supported in Tamaro. This method is intended for use with payment agreements. Agreements created using this method will automatically receive a 27-digit reference number (ISR). References are unique within the account in which they are created.
Customers who wish to generate Swiss QR invoices using RaiseNow must provide a valid QR-IBAN (a Swiss IBAN with a 3 as the fifth digit). Donors using this payment method can download a PDF containing the Swiss QR bill with the generated reference number.
Processing recurring card payments via PayPal
Customers can now use PayPal to process recurring card payments. Donors enter their card details directly in the donation form, and credit card charges are processed through the customer's PayPal account. Support for one-off payments will follow shortly.
Processing cancellations from PayPal
PayPal users can terminate recurring billing agreements within PayPal. These cancellations are now propagated to RaiseNow and will result in the cancellation of the corresponding subscription.
Setting additional information in custom_id in PayPal
For PayPal payments initiated via RaiseNow Hub, additional information will now be sent to PayPal in the custom_id
field to support reconciliation for customers using PayPal exports or the PayPal API. The custom_id
field will contain an object with the following fields (when applicable):
{
"subscription": "c75267d7-5e3d-4cbf-a310-9f4c248e9",
"supporter": "ee8d5bf3-0794-45d1-83ff-5d76a02de16",
"invoice": "d5ad15cf-a40d-46b2-983f-d2b58f414970"
}
Supporting recurring PayPal payments on RaiseNow Hub solutions
Not all RaiseNow customers are automatically eligible to vault payment methods with PayPal. However, vaulting is required for processing recurring payments via our new PayPal integration. RaiseNow Hub now automatically detects the capabilities of the customer’s PayPal account and will offer recurring PayPal options if the required capabilities are available.
Added support for exists queries to the Search API
Consumers of the API now have a new query option to search for the existence of certain parameters or values. This frequently requested feature is especially useful for partners using the API for custom integrations. See our updated documentation for more details.
TWINT status updates on the RaiseNow status page
You can now monitor TWINT service availability on the RaiseNow status page. The following providers are now listed at status.raisenow.com:
- TWINT
- Datatrans
- Ingenico Collect
- PayPal
- Stripe
- Adyen
Bugfixes and other improvements
We constantly provide improvements and changes under the hood that are not directly noticable, but add to an improved experience when using RaiseNow tools. Among other things we provided the following improvements:
- Improvements to the handling of webhooks received from PayPal
- Improvements to webhooks received from Stripe
- Various improvements to our integration with Sreedly
- Various improvements to record anonymization
- Automatically detect card brands based on the first six digits of the card number