Skip to main content

(Classic) Redsys for FinDock

END-OF-LIFE ANNOUNCEMENT

This article describes Redsys integration with version 1 of the Payment API. The Classic Online Experience with Payment API version 1 will be decommissioned at the end of 2024. All Payment API integrations should migrate to version 2, the Enhanced Online Experience, by January 2025.

The Redsys for FinDock payment extension introduces support for Redsys, a Spanish Payment Service Provider operating in Europe and Latin American to FinDock. The extension adds recurring credit card payments as a payment method for Redsys.

note

The Redsys for FinDock extension can only be used for recurring credit card payments. It is the customer's responsibility to retrieve the Redsys tokens, which are required to collect recurring payments using a Payment Schedule, and store them cpm__token__c field on the Payment Profile.

Multi-merchantMulti-currency
nono
Payment MethodOne-timeRecurringRefunds
Credit Cardnoyesno

Pre-requisites

  • FinDock Core (formerly PaymentHub) is installed and configured.
  • ProcessingHub is installed and configured.
  • A source connector is installed and configured.
info

The Redsys for FinDock package is not pushable, so we cannot automatically update your org with the normal release process. To receive updates, enhancements and fixes, you need to manually install the latest package version using the FinDock Installer.

Install and activate Redsys extension

The installation and initial setup differ from other packages. Also a specific engine account is required. Please contact support@findock.com if you plan to install Redsys. Once installed, follow the standard procedure to activate the Redsys extension.

Configure Redsys for FinDock

After activating the Redsys extension, you need to activate a payment method, deploy the configuration, and then complete the Redsys PSP settings.

To configure Redsys for FinDock:

  1. On the same tab where you activated the Redsys extension, click the Payment Methods button in the far right column and activate the payment method 'CreditCard'.
  2. Click on the Deploy-Config button. This automatically deploys the payment extension value ‘PaymentHub-Redsys’ and payment method value ‘CreditCard’ to picklists for relevant object fields.
  3. Go back to the FinDock Setup home page, scroll down to the Payment Extensions section and click on the PaymentHub-Redsys tile.
  4. Configure the Redsys settings by populating all fields with the information found in your Redsys merchant account.
  • The Merchant Transaction Type can be used to indicate what type of transaction it is. The possible values are:
    • A – Traditional payment
    • 1 – Preauthorisation
    • O – Deferred Authorisation
  • Fill in the correct endpoint in the Redsys Endpoint:
  • For Production: https://sis.redsys.es/sis/services/SerClsWSEntrada
  • For Test: https://sis-t.redsys.es:25443/sis/services/SerClsWSEntrada

Collect payments using Redsys

To collect payments using Redsys as a processor, you need to execute a bulk collection run. If you haven’t already, please take a moment to read about payment collection. Although executing a Redsys bulk collection run is similar, there are some significant differences.

To run a bulk collection for Redsys:

  1. Create a payment schedule and populate at least the following fields:
    • Status = Scheduled
    • Source = For example: PaymentHub-for-NPSP
    • Payment Processor = PaymentHub-Redsys
    • Payment Method = CreditCard
    • Target = Because only one Redsys target can be configured per org, this field is inactive.
    • Collection date = A value is required. However, installments are collected immediately after executing the Payment Schedule, therefore any date can be added.
    • Run date = Today
    • Selection Date = Any date. All installments with a due date on or before the selection date are included in the run (provided they have the correct source, payment method, processor and target).
  2. Execute the payment schedule by changing the status to Generate or clicking the Start Generation button.
    • As with a regular payment schedule, in this step all eligible installments for this collection run are added to the payment schedule. This step is finished when the status of the payment schedule changes to Generated. At least the following needs to be true for installments to be added to the payment schedule:
      • The status of the installment should be New.
      • Source, payment method, payment processor values have to match the payment schedule being executed.
      • The due date has to be on or before the selection date on the payment schedule.
  3. After you’ve verified all installments eligible for this run are added to the payment schedule, click Process or change the status of the schedule to Process.
    • This step is noticeably different compared to a regular payment schedule because all installments will be sent to Redsys for processing.
      • If installments are processed successfully, they are closed as ‘collected’ and payments are created.
      • If for some reason Redsys wasn’t able to process installments, the status of these installments is set to ‘failed.’ The failure reason is recorded in the Last Status Reason field.
    • When all installments are processed, the payment schedule is set to ‘Done.’

FinDock saves the request sent to Redsys and the response received from Redsys on the individual installment records. These raw messages can be found in the fields:

  • Last Raw Request
  • Last Raw Response