Skip to main content

Redsys

Redsys Bizum

Configure the following parameters for the Connector (see Connector Config - Redsys Bizum):

  1. Fill in the Merchant Id
    The merchantId is a unique ID, assigned to the merchant from Redsys after registration, to identify the merchant.
  2. Select the Language
  3. Check option the Test Mode (see also https://pagosonline.redsys.es/bizum.html)
    If you enable the Test Mode transactions will be sent to corresponding testEnvironment:
  4. Select the testEnvironment
    • TEST_SYS_I
    • TEST_SYS_T
  5. Fill in the mandatory terminalId
  6. Fill in the mandatory paramsKey
    Key to sign MerchantParameters.
  7. Fill in the optional merchantDescriptor
    Will be sent as DS_MERCHANT_MERCHANTDESCRIPTOR if configured.
  8. Fill in the optional registerAmount
    Mandatory for register transactions.
  9. Fill in the optional registerCurrency
    Mandatory for register transactions.
  10. Select the optional Extra Data: signatureVersion
    Default Version is T25V1 if none is selected.
    Use HMAC_SHA256_V1 for the merchant integration.
    Use T25V1 for the provider integration.
    Note: Check with your Redsys account manager to find out which is the correct one for your account.
  11. Select the optional errorUrl
    Only set to true to send the error URL.
  12. Select the optional make_separate_RTP_request
    For Debit and Register Transactions.
    If set to true, an extra Ready To Pay (RTP) call will be executed before the actual register/payment call to the PSP. The call does not affect the transaction and is used to check whether the customer has Bizum activated or not based on the provided billing phone number. The result of the RTP call will be added as extraData in the result.
  13. Select the optional requestMerchantCofTxnId
    Enable this setting to send following parameters for register transactions:
    • DS_MERCHANT_COF_TYPE = R
    • DS_MERCHANT_COF_INI = S
note

For the RedsysPci adapter Fallback / Cascading only works for the adapter error code 195!

Redsys Creditcard

Configure the following parameters for the Connector (see Connector Detail Overview - Redsys - Vault Configuration):

  1. Select the mandatory Environment: Production, Sandbox, Sandbox_SYS_T
  2. Select the optional Endpoint Type: Merchant, PSP
  3. Select the optional Signature Version: T25V1, HMAC_SHA256_V1
  4. Fill in the mandatory Terminal Id (see also https://pagosonline.redsys.es/entornosPruebas.html)
  5. Fill in the mandatory Merchant Id (see also https://pagosonline.redsys.es/entornosPruebas.html Merchant Code)
  6. Fill in the optional Key to perform 3DES Card encryption (see also https://pagosonline.redsys.es/conexion-rest.html)
  7. Fill in the optional Key to sign MerchantParameters — ParamsKey given by Redsys
  8. Fill in the optional Merchant Descriptor
  9. Fill in the optional Username to load stored Production Credentials (Credentials given by the IXOPAY platform in case the Key to perform 3DES Card encryption is stored in the IXOPAY platform)
  10. Fill in the optional Password to load stored Production Credentials (Credentials given by the IXOPAY platform in case the Key to perform 3DES Card encryption is stored in the IXOPAY platform)

The IXOPAY platform provides additional options

  1. Check optional option to Prioritize Description Field over MerchantTransactionId Field: to enable the prioritizing of the "Description" field over the "MerchantTransactionId" field, send in the request.
  2. Check optional option to Assign Timestamp to empty Description Field (to prevent empty fields)
  3. Check optional option to enable Increment order id (appends suffix/replaces last 2 characters if too long)
tip

In case you want to use the additional options Prioritize Description Field over MerchantTransactionId Field and Assign Timestamp to empty Description Field, please make sure to send an empty description field in the transaction request.

note

Be aware regarding the format restrictions on Redsys side https://pagosonline.redsys.es/conexion-rest.html.