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 |
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 |
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 |