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 Method	Transaction Flows	Transaction Types
CreditCard	payment.js	Debit, Preauthorize, Capture, Refund, Void, Register
ApplePay		Payment Token
GooglePay		Payment Token
Bizum	Redirect	Debit, Refund
BizumAPI	API	Register, 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)

Key	Required	Type	Description
Terminal Id	true	string	A fixed value given by Redsys for each Merchant
Merchant Id	true	string	A fixed value given by Redsys for each Merchant
Key to perform 3DES Card encryption	conditional	string	A fixed value given by Redsys for each Merchant
Key to sign MerchantParameters	conditional	string	A fixed value given by Redsys for each Merchant
Merchant Descriptor	conditional	string	Value which will be sent as DS_MERCHANT_MERCHANTDESCRIPTOR
Username to load stored Production Credentials	conditional	string	Username that is given by us in case "Key to perform 3DES Card encryption" is stored internally by us
Password to load stored Production Credentials	conditional	string	Password that is given by us in case "Key to perform 3DES Card encryption" is stored internally by us
Prioritize Description Field over MerchantTransactionId Field	false	boolean	In case that the "Description" Field, send in the Request, should be used instead of the "MerchantTransactionId" Field
Assign Timestamp to empty Description Field	false	boolean	In 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 id	false	boolean	In 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

Parameter	maps to
description	DS_MERCHANT_PRODUCTDESCRIPTION

Bizum and BizumAPI

Connector Config

Key	Required	Type	Description
Terminal Id	true	string	A fixed value given by Redsys for each Merchant
Merchant Id	true	string	A fixed value given by Redsys for each Merchant
ParamsKey	true	string	A fixed value given by Redsys for each Merchant
merchantDescriptor	false	string	A merchant descriptor (for BizumAPI)
registerAmount	false	string	should be set to 0.01 but might b different in the future (for BizumAPI)
registerCurrency	false	string	the three letter currency code (for BizumAPI)
make_separate_RTP_request	false	boolean	to 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

Key	Type	Required	maps to
description	Register, Debit, Refund	false	DS_MERCHANT_PRODUCTDESCRIPTION
transactionIndicator	Debit	conditional	Subsequent Transactions must have a transactionIndicator [CARDONFILE, CARDONFILE-MERCHANT-INITIATED]
customer.billingPhone	Register, Debit	true	DS_MERCHANT_BIZUM_MOBILENUMBER
extraData.exemptionIndicator	Debit	false	DS_MERCHANT_EXCEP_SCA
extraData.merchantData	Debit	false	DS_MERCHANT_MERCHANTDATA
extraData.transactionType	Debit	false	DS_MERCHANT_TRANSACTIONTYPE

possible values of exemptionIndicator

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