python-redsys 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

{python_redsys-2.0.0.dist-info → python_redsys-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-redsys
-Version: 2.0.0
+Version: 2.1.0
 Summary: A simple, lightweight client to handle payments through the RedSys platform.
 Author-email: David Díaz <d.diazp@gmail.com>
 License-Expression: Apache-2.0
@@ -48,6 +48,17 @@ pip install "python-redsys[http]"
 
 Requires Python 3.10+. Runtime dependencies: `cryptography` and `pydantic` (v2).
 
+## Status
+
+| | |
+|---|---|
+| Version | 2.1.0; 1.x receives fixes until 2026-12-31 |
+| Python | 3.10 to 3.15 |
+| RedSys documents followed | Redirection guide 4.2 (2026-02-04), REST guide 4.0.1 (2025-10-17), Bizum guide 2.6 (2026-08-25) |
+| Signature versions | `HMAC_SHA512_V2` (default), `HMAC_SHA512_V1`, `HMAC_SHA256_V1` |
+| Verified against the RedSys test environment | Redirect connection in a browser, with the 3DS challenge, for all three signature versions (2026-10-25); direct connection end to end (3DS initialization, challenged payment, refund, stored-card token charged as a merchant-initiated payment) on demand by the *Live* workflow |
+| Not yet verified live | Frictionless 3DS and the 3DSMethod step |
+
 ## Upgrading from 1.x
 
 2.0 has a new API. The [migration guide](docs/migration-1x-to-2x.md) lists every change; 1.x receives fixes until 2026-12-31.
@@ -194,7 +205,7 @@ client.payment(
 ).send()
 ```
 
-`redsys.cof` provides the indicator constants (`INITIAL`/`SUBSEQUENT`, `RECURRING`/`INSTALLMENT`/...) and the `REQUEST_TOKEN` sentinel. The periodic fields (`sum_total`, `date_frequency`, `charge_expiry_date`) are also accepted by `DirectClient.payment()`. `redsys.sca` holds the PSD2 exemption codes for `excep_sca` (`LWV`, `TRA`, `MIT`, `COR`, `ATD`); `sca.QUERY` on `inicia()` asks which exemptions the card allows, returned in `response.excep_sca`.
+`redsys.cof` provides the indicator constants (`INITIAL`/`SUBSEQUENT`, `RECURRING`/`INSTALLMENT`/...) and the `REQUEST_TOKEN` sentinel. The token and COF fields are also accepted by `RedirectClient.payment()`, so the first payment can run on the RedSys page. The periodic fields (`sum_total`, `date_frequency`, `charge_expiry_date`) are accepted by `DirectClient.payment()`. `redsys.sca` holds the PSD2 exemption codes for `excep_sca` (`LWV`, `TRA`, `MIT`, `COR`, `ATD`); `sca.QUERY` on `inicia()` asks which exemptions the card allows, returned in `response.excep_sca`.
 
 ## Signature versions
 

{python_redsys-2.0.0.dist-info → python_redsys-2.1.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-python_redsys-2.0.0.dist-info/licenses/LICENSE,sha256=qsc7MUj20dcRHbyjIJn2jSbGRMaBOuHk8F9leaomY_4,11360
-python_redsys-2.0.0.dist-info/licenses/NOTICE,sha256=6tlv5QuzsbfmGxsQNEcN7Uopzyp7vgD54xb-_L4DGyE,201
+python_redsys-2.1.0.dist-info/licenses/LICENSE,sha256=qsc7MUj20dcRHbyjIJn2jSbGRMaBOuHk8F9leaomY_4,11360
+python_redsys-2.1.0.dist-info/licenses/NOTICE,sha256=6tlv5QuzsbfmGxsQNEcN7Uopzyp7vgD54xb-_L4DGyE,201
 redsys/__init__.py,sha256=bhpyzXB0Y-3FORBJlV4dZ3vnrz1jSc-sbZ9hyb7itFo,138
-redsys/clients.py,sha256=4_lM6c6ofb13z_GNMa4d7pTCn2R6zbSRYrKJLfNdejA,10710
+redsys/clients.py,sha256=b9K4jCSLC9JNWUS8wVFqkc9im_a5ukSA-JpunbhKEBc,11067
 redsys/crypto.py,sha256=GOm8RkDYnD83fMNwey-bxLg3vWf6xbNzWbza6m23M9M,5480
 redsys/exceptions.py,sha256=MqknsHm4sI5iAelrYcAuqSC70u1hhqdLyvA27vKcLHY,601
-redsys/models.py,sha256=UzvCBrYgwixTS-b4PjMaeLCg7txNlWkcs0vmWeX94SM,15765
+redsys/models.py,sha256=9YqPBUc0LgEEFhvZiwzdM16w2DyqICF5DnXrvrVK4Po,16653
 redsys/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 redsys/request.py,sha256=dVAQ0zSVmdyUPjnERo_62xilNQk3-LGJTbR6im_y0fQ,2408
 redsys/threeds.py,sha256=IheD2mWVD9Pw7efRP6_a170LVppSSlKpyxhUJVI3LnU,2244
@@ -13,8 +13,8 @@ redsys/api/cof.py,sha256=fEf9ugVvOMs-jAzXkXDQl4NshyZuSYvbYfqnRH8otrk,660
 redsys/api/currencies.py,sha256=GufqxjAb941KMZ2S2mJJ980Xz4naJ2GgkcOVwuPx0ms,1043
 redsys/api/languages.py,sha256=GPw7JB-CWDyGo6vhcPZDzpjGuwkojFCz1gyfx13wlek,872
 redsys/api/sca.py,sha256=09b9LV9dvBADDTfHnReMR3OuM38ViVRqQs_hLQFBEoE,786
-redsys/api/transactions.py,sha256=HYmaEXsfAb9-Kc9WlTGTetEA23vM1aGsQQua2Ukk3PM,732
-python_redsys-2.0.0.dist-info/METADATA,sha256=lWRxu0v6tYC3RHfS3Rp29hXH8zL6c6scMm7anIUVY3k,9793
-python_redsys-2.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-python_redsys-2.0.0.dist-info/top_level.txt,sha256=79TrHj--FP5SDyZO42-NUsiYJmHiQX42txZigHOqghY,7
-python_redsys-2.0.0.dist-info/RECORD,,
+redsys/api/transactions.py,sha256=MzBdsgn_27_nayxCavs15tXQShjm4NsGbQVAeTn9oTg,1633
+python_redsys-2.1.0.dist-info/METADATA,sha256=Q9DeegOyNcRZ76kari8o2O9Rh_d-DOHt2Qfu7yk9tJk,10632
+python_redsys-2.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+python_redsys-2.1.0.dist-info/top_level.txt,sha256=79TrHj--FP5SDyZO42-NUsiYJmHiQX42txZigHOqghY,7
+python_redsys-2.1.0.dist-info/RECORD,,

redsys/api/transactions.py

@@ -19,6 +19,9 @@ AUTHENTICATION_CONFIRMATION = 8
 CANCELLATION = 9
 """Cancellation"""
 
+REPLACEMENT_PREAUTHORIZATION = 11
+"""Replacement preauthorization: extends an existing preauthorization."""
+
 PAY_GOLD = 15
 """Pay gold"""
 
@@ -31,6 +34,24 @@ REFUND_WITHOUT_ORIGINAL = 34
 BETTING_PRICE = 37
 """Betting price"""
 
+PAY_GOLD_AUTHORIZATION = 38
+"""PayGold authorization: the cardholder completes a PayGold request (type 15); sent by RedSys, not the merchant."""
+
+DELETE_REFERENCE = 44
+"""Delete a stored card reference (token)."""
+
+PAYMENT_CANCELLATION = 45
+"""Payment cancellation, for merchant time-outs or technical errors."""
+
+REFUND_CANCELLATION = 46
+"""Refund cancellation, within 48 hours of the refund."""
+
+AUTHENTICATION_CONFIRMATION_CANCELLATION = 47
+"""Cancellation of an authentication confirmation (type 8)."""
+
+PARTIAL_CONFIRMATION = 48
+"""Partial confirmation of a preauthorization."""
+
 TRANSACTION_TYPES = (
     AUTHORIZATION,
     PREAUTHORIZATION,
@@ -39,8 +60,15 @@ TRANSACTION_TYPES = (
     AUTHENTICATION,
     AUTHENTICATION_CONFIRMATION,
     CANCELLATION,
+    REPLACEMENT_PREAUTHORIZATION,
     PAY_GOLD,
     AUTHENTICATION_PUCE,
     REFUND_WITHOUT_ORIGINAL,
     BETTING_PRICE,
+    PAY_GOLD_AUTHORIZATION,
+    DELETE_REFERENCE,
+    PAYMENT_CANCELLATION,
+    REFUND_CANCELLATION,
+    AUTHENTICATION_CONFIRMATION_CANCELLATION,
+    PARTIAL_CONFIRMATION,
 )

redsys/clients.py

@@ -209,6 +209,11 @@ class _DirectBase(Client):
         transactions.CONFIRMATION: ConfirmationMessage,
         transactions.REFUND: RefundMessage,
         transactions.CANCELLATION: CancellationMessage,
+        transactions.REPLACEMENT_PREAUTHORIZATION: DirectPreauthorizationMessage,
+        transactions.PARTIAL_CONFIRMATION: ConfirmationMessage,
+        transactions.PAYMENT_CANCELLATION: CancellationMessage,
+        transactions.REFUND_CANCELLATION: CancellationMessage,
+        transactions.AUTHENTICATION_CONFIRMATION_CANCELLATION: CancellationMessage,
     }
 
     @property

redsys/models.py

@@ -20,7 +20,7 @@ from json import dumps, loads
 from typing import Any
 from warnings import warn
 
-from pydantic import BaseModel, ConfigDict, Field, field_serializer, field_validator, model_validator
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field, field_serializer, field_validator, model_validator
 
 from redsys.api.currencies import CURRENCIES, CURRENCY_DECIMALS
 from redsys.api.transactions import TRANSACTION_TYPES
@@ -43,10 +43,14 @@ def decode_merchant_parameters(data: bytes) -> dict:
     return loads(b64decode(data + b'=' * (-len(data) % 4)).decode('utf-8'))
 
 
+def currency_decimals(currency: int | None) -> int:
+    """ISO-4217 minor-unit exponent of a currency; 2 when unknown."""
+    return CURRENCY_DECIMALS.get(currency, 2) if currency is not None else 2
+
+
 def minor_units_factor(currency: int | None) -> int:
     """Power-of-ten factor that converts major units to the wire minor units."""
-    decimals = CURRENCY_DECIMALS.get(currency, 2) if currency is not None else 2
-    return 10**decimals
+    return 10 ** currency_decimals(currency)
 
 
 class BaseRequest(BaseModel):
@@ -117,7 +121,19 @@ class BaseRequest(BaseModel):
         return b64encode(dumps(self.prepare_parameters(), sort_keys=True).encode('utf-8'))
 
 
-class _RedirectFields(BaseModel):
+class _StoredCredentialFields(BaseModel):
+    """Tokenization and credential-on-file fields, accepted by both connections."""
+
+    identifier: str | None = Field(
+        None, alias='Ds_Merchant_Identifier', max_length=40, description='Stored-card token; see redsys.api.cof.'
+    )
+    direct_payment: str | None = Field(None, alias='Ds_Merchant_DirectPayment', description='"true" or "moto".')
+    cof_ini: str | None = Field(None, alias='Ds_Merchant_Cof_Ini', max_length=1, description='See redsys.api.cof.')
+    cof_type: str | None = Field(None, alias='Ds_Merchant_Cof_Type', max_length=1, description='See redsys.api.cof.')
+    cof_txnid: str | None = Field(None, alias='Ds_Merchant_Cof_Txnid', max_length=15)
+
+
+class _RedirectFields(_StoredCredentialFields):
     """Fields of the redirect connection (browser form)."""
 
     merchant_url: str | None = Field(None, alias='Ds_Merchant_MerchantURL', max_length=250)
@@ -137,24 +153,20 @@ class _RedirectFields(BaseModel):
     )
 
 
-class _DirectFields(BaseModel):
+class _DirectFields(_StoredCredentialFields):
     """Fields of the direct connection (server-to-server card data, 3DS, stored credentials)."""
 
     pan: str | None = Field(None, alias='Ds_Merchant_Pan', max_length=19, pattern=r'^[0-9]{12,19}$')
     expiry_date: str | None = Field(None, alias='Ds_Merchant_ExpiryDate', pattern=r'^[0-9]{4}$', description='YYMM.')
     cvv2: str | None = Field(None, alias='Ds_Merchant_Cvv2', pattern=r'^[0-9]{3,4}$')
-    identifier: str | None = Field(
-        None, alias='Ds_Merchant_Identifier', max_length=40, description='Stored-card token; see redsys.api.cof.'
-    )
     idoper: str | None = Field(None, alias='Ds_Merchant_Idoper', max_length=40, description='inSite operation token.')
-    direct_payment: str | None = Field(None, alias='Ds_Merchant_DirectPayment', description='"true" or "moto".')
     emv3ds: dict[str, Any] | None = Field(None, alias='Ds_Merchant_EMV3DS', description='Build with redsys.threeds.')
-    cof_ini: str | None = Field(None, alias='Ds_Merchant_Cof_Ini', max_length=1, description='See redsys.api.cof.')
-    cof_type: str | None = Field(None, alias='Ds_Merchant_Cof_Type', max_length=1, description='See redsys.api.cof.')
-    cof_txnid: str | None = Field(None, alias='Ds_Merchant_Cof_Txnid', max_length=15)
     # RedSys spells the wire name "Frecuency".
     date_frequency: str | None = Field(None, alias='Ds_Merchant_DateFrecuency', description='Days between charges.')
     charge_expiry_date: str | None = Field(None, alias='Ds_Merchant_ChargeExpiryDate', description='yyyy-MM-dd.')
+    dcc: str | dict[str, Any] | None = Field(
+        None, alias='Ds_Merchant_DCC', description='"Y" on the 3DS initialization; then the accepted offer.'
+    )
     excep_sca: str | None = Field(
         None,
         alias='Ds_Merchant_Excep_SCA',
@@ -243,13 +255,17 @@ class Response(BaseModel):
     secure_payment: str | None = Field(None, alias='Ds_SecurePayment')
     authorization_code: str | None = Field(None, alias='Ds_AuthorisationCode')
     error_code: str | None = Field(None, alias='Ds_ErrorCode')
-    card_number: str | None = Field(None, alias='Ds_CardNumber')
+    # REST responses send Ds_CardNumber; redirect notifications send Ds_Card_Number.
+    card_number: str | None = Field(
+        None, alias='Ds_CardNumber', validation_alias=AliasChoices('Ds_CardNumber', 'Ds_Card_Number', 'card_number')
+    )
     expiry_date: str | None = Field(None, alias='Ds_ExpiryDate')
     card_psd2: str | None = Field(None, alias='Ds_Card_PSD2')
     excep_sca: str | None = Field(
         None, alias='Ds_Excep_SCA', description='Exemptions the card allows, from the 3DS initialization.'
     )
     emv3ds: dict[str, Any] | None = Field(None, alias='Ds_EMV3DS')
+    dcc: dict[str, Any] | None = Field(None, alias='Ds_DCC', description='Offer from the 3DS initialization.')
     identifier: str | None = Field(None, alias='Ds_Merchant_Identifier', description='Token returned on request.')
     cof_txnid: str | None = Field(None, alias='Ds_Merchant_Cof_Txnid')
     processed_pay_method: str | None = Field(None, alias='Ds_ProcessedPayMethod', description='68 = Bizum.')
@@ -269,7 +285,8 @@ class Response(BaseModel):
     def from_merchant_parameters(cls, merchant_parameters: bytes) -> 'Response':
         response = cls.model_validate(decode_merchant_parameters(merchant_parameters))
         if response.amount is not None:
-            response.amount = response.amount / minor_units_factor(response.currency)
+            # scaleb keeps the currency's decimals: 100 EUR minor units read as 1.00, not 1.
+            response.amount = response.amount.scaleb(-currency_decimals(response.currency))
         return response
 
     def get_order(self) -> str | None:
@@ -336,5 +353,6 @@ __all__ = [
     'CancellationMessage',
     'Response',
     'decode_merchant_parameters',
+    'currency_decimals',
     'minor_units_factor',
 ]