Skip to main content

Redsys

This page provides an overview of the payments methods provided by the Redsys adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Redsys within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment MethodTransaction FlowsTransaction Types
CreditCardpayment.jsDebit, Preauthorize, Capture, Refund, Void, Register
ApplePayPayment Token
GooglePayPayment Token
BizumRedirectDebit, Refund
BizumAPIAPIRegister, Debit, Refund

Additional Information

Be aware that there is a format restriction for the required Parameter DS_MERCHANT_ORDER, which represents the given MerchantTransactionId. The currently known max character limit is 12.

Please consult the official Redsys Api Documentation for further information - (https://pagosonline.redsys.es/conexion-rest.html)

CreditCard

Connector Config (Vault Setup)

KeyRequiredTypeDescription
Terminal IdtruestringA fixed value given by Redsys for each Merchant
Merchant IdtruestringA fixed value given by Redsys for each Merchant
Key to perform 3DES Card encryptionconditionalstringA fixed value given by Redsys for each Merchant
Key to sign MerchantParametersconditionalstringA fixed value given by Redsys for each Merchant
Merchant DescriptorconditionalstringValue which will be sent as DS_MERCHANT_MERCHANTDESCRIPTOR
Username to load stored Production CredentialsconditionalstringUsername that is given by us in case "Key to perform 3DES Card encryption" is stored internally by us
Password to load stored Production CredentialsconditionalstringPassword that is given by us in case "Key to perform 3DES Card encryption" is stored internally by us
Prioritize Description Field over MerchantTransactionId FieldfalsebooleanIn case that the "Description" Field, send in the Request, should be used instead of the "MerchantTransactionId" Field
Assign Timestamp to empty Description FieldfalsebooleanIn case that the "Description" Field should be automatically filled with the current Timestamp. Works in conjunction with the "Prioritize Description Field over MerchantTransactionId Field" Option.
Increment order idfalsebooleanIn case of transaction failover/cascading, the order ID (merchantTransactionId) will be automatically incremented to prevent a duplicate order ID. Note: if the merchantTransactionId = 12 length, the last 2 characters will be replaced for the increment

Note: If the options Prioritize Description Field over MerchantTransactionId Field & Assign Timestamp to empty Description Field are enabled simultaneously the first 6 characters of the respective Transaction are appended to the timestamp to ensure uniqueness.

Parameter mapping

Parametermaps to
descriptionDS_MERCHANT_PRODUCTDESCRIPTION

Bizum and BizumAPI

Connector Config

KeyRequiredTypeDescription
Terminal IdtruestringA fixed value given by Redsys for each Merchant
Merchant IdtruestringA fixed value given by Redsys for each Merchant
ParamsKeytruestringA fixed value given by Redsys for each Merchant
merchantDescriptorfalsestringA merchant descriptor (for BizumAPI)
registerAmountfalsestringshould be set to 0.01 but might b different in the future (for BizumAPI)
registerCurrencyfalsestringthe three letter currency code (for BizumAPI)
make_separate_RTP_requestfalsebooleanto perform an RTA request before the payment/enrollment call, without affecting it (for BizumAPI), the result of this call will be added to the transaction result

SideNote: The merchantTransactionId which has to be sent in the API request, must be between 4 and 12 Characters long to work for Bizum and BizumAPI.

Field Mapping For BizumAPI

KeyTypeRequiredmaps to
descriptionRegister, Debit, RefundfalseDS_MERCHANT_PRODUCTDESCRIPTION
customer.billingPhoneRegister, DebittrueDS_MERCHANT_BIZUM_MOBILENUMBER
extraData.exemptionIndicatorDebitfalseDS_MERCHANT_EXCEP_SCA
extraData.merchantDataDebitfalseDS_MERCHANT_MERCHANTDATA
extraData.transactionTypeDebitfalseDS_MERCHANT_TRANSACTIONTYPE

possible values of exemptionIndicator

valuevalue sent to psp
01LWV
02TRA
03ATD
04COR
05MIT