Unable to link recurring gift to recurring gift payments

Marlin Integrations

Our system takes an initial payment and then sets up a recurring gift schedule within RE NXT. We would like to link the initial payment to the recurring gift. (RecurringGiftPayment -→ Recurring Gift)

We are following the GIFT API and including the linked_gifts as per the documentation, however this results in the following error:

[{ "message": "Can't approve this payment because it isn't linked to a recurring gift. To resolve, contact Support.", "error_name": "GiftDataAccessRE7LinkedRecurringGiftDoesNotExist", "error_code": 11, "raw_message": "Can't approve this payment because it isn't linked to a recurring gift. To resolve, contact Support." }]

We have tried passing it as:

1. A String
2. An Array of strings
3. An array of ints

Documentation mentions array of strings, however none of them seem to work as expected.

We get the following error within RE NXT:

I have further added a screenshot of the request:

I would like to know the correct process of adding RecurringGiftPayment's as we need to resolve this issue urgently.

I found the following resources on the community forum:

Anthony Gallo

Do you have the “Is_Manual” flag enabled on these recurring gifts? We only allow payments to be applied to legacy database view RGs. Anything without that flag is considered an NXT gift and those will only process thru our system.

Marlin Integrations

Hi Anthony,

Thank you for your response and the is_manul does seem to work in the console. I did test this with our implementation and found an issue with the returned GIFT ID. (for the Recurring Gift).

The returned ID is - 139478

However it seems like we need the ID from the URL 597909 (This is an existing recurring GIFT). I have provided an example URL below:

We are also using Batches to process the Gifts - API URL provided below.

Please find below the return response from SKY API:

{
"errors":[
],
"gifts":[
{
"errors":[

],
"id":"139478",
"acknowledgements":[

],
"amount":{
"value":33.0
},
"constituent_id":"101350",
"date":"2022-02-23T00:00:00",
"fundraisers":[

],
"gift_splits":[
{
"amount":{
"value":33.0
},
"appeal_id":"781",
"campaign_id":"417",
"fund_id":"62"
}
],
"gift_status":"Active",
"is_anonymous":false,
"linked_gifts":[

],
"lookup_id":"cded7285-d94d-44c9-bf76-6f3bc2bcb042",
"origin":"{\\"name\\": \\"API\\"}",
"payments":[
{
"account_token":"removed",
"bbps_configuration_id":"removed",
"bbps_transaction_id":"b19a846f-13ac-46cf-8173-e53134eb362d",
"payment_method":"CreditCard"
}
],
"post_status":"DoNotPost",
"receipts":[
{
"amount":{
"value":33.0
},
"status":"DONOTRECEIPT"
}
],
"recurring_gift_schedule":{
"frequency":"MONTHLY",
"start_date":"2022-03-20T10:59:59+11:00"
},
"recurring_gift_status_date":{
"d":23,
"m":2,
"y":2022
},
"reference":"Newly added gift",
"soft_credits":[

],
"type":"RecurringGift"
}
]
}

Marlin Integrations

Is there any work around to append Recurring Gift Payments to Recurring Gifts when using batches?

We are currently trying to solve this issue as this is pending go live.

Anthony Gallo

Recurring Gifts will need to be approved before we can apply the payments to those items. The batch approval process needs to be completed. Once the batch is approved you will use the ID of the recurring gift to apply the payment.