Recuva Mandate Setup

Direct debit mandate provider via Recuva.

Configuration Keys

Key	Description
RECUVA_MANDATE_ENABLED	Enable Recuva mandates
RECUVA_API_BASE_URL	Recuva API endpoint
RECUVA_API_KEY	API key
RECUVA_WEBHOOK_SECRET	Webhook verification secret
RECUVA_INSTITUTION_CODE	Institution identifier
RECUVA_MANDATE_INITIATE_ENDPOINT	Mandate initiation path
RECUVA_MANDATE_RETRIEVE_ENDPOINT	Mandate retrieval path
RECUVA_MANDATE_CANCEL_ENDPOINT	Cancellation path
RECUVA_MANDATE_PAUSE_ENDPOINT	Pause path
RECUVA_MANDATE_REINSTATE_ENDPOINT	Reinstate path
RECUVA_DIRECT_DEBIT_REPAYMENT_ENDPOINT	Debit repayment path
MANDATE_DEFAULT_PROVIDER	Set to Recuva

Webhooks

Recuva sends callbacks to:

• POST /api/integrations/recova/v1/{institutionId}/SmsAlert
• POST /api/integrations/recova/v1/{institutionId}/MandateCreation
• POST /api/integrations/recova/v1/{institutionId}/LoanBalanceUpdate
• GET /api/integrations/recova/v1/{institutionId}/LoanDueAmount/{reference}

Troubleshooting

• Webhook HMAC fails: Verify RECUVA_WEBHOOK_SECRET matches Recuva dashboard
• Mandate creation returns 403: Check RECUVA_API_KEY validity