Merge branch 'master' into develop

CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All Notable changes to `Redsys` will be documented in this file
 
+## Version 1.4.8 (2024-03-05)
+### Added
+- Implementation of the `xpay` method within the `setMethod` functionality to support GooglePay and ApplePay.
+
+- TDD (Test Driven Development) implementation for enhanced code reliability and maintainability.
+
+### Changed
+- Possible internal changes were made to integrate the `xpay` method and accommodate the TDD implementation, ensuring code consistency.
+
+### Fixed
+- None
+
+## Version 1.4.7 (2024-02-24)
+### Added
+- Static validation methods for convenience and reusability.
+
+- Tests for the new methods and functionalities, ensuring code quality and stability.
+
+### Changed
+- Possible internal changes were made to implement the new features.
+### Fixed
+- None
+
 ## Version 1.4.6 (2023-10-28)
 
 ### Added

composer.json

@@ -19,7 +19,8 @@
   },
   "autoload": {
     "psr-4": {
-      "Sermepa\\Tpv\\": "src/Sermepa/Tpv/"
+      "Sermepa\\Tpv\\": "src/Sermepa/Tpv/",
+      "Redsys\\": "src/Redsys/"
     }
   },
   "minimum-stability": "stable"

doc/Tabla DS_MERCHANT_CONSUMERLANGUAGE.md

@@ -0,0 +1,35 @@
+# Tabla DS_MERCHANT_CONSUMERLANGUAGE
+| CÓDIGO ISO | IDIOMA |
+|------------|-|
+| 0 | Por defecto - Español |
+| 1 | Español |
+| 2 | English - Ingles |
+| 3 | Català |
+| 4 | Français - Frances |
+| 5 | Deutsch - Aleman |
+| 6 | Nederlands - Holandes |
+| 7 | Italiano |
+| 8 | Svenska - Sueco |
+| 9 | Português |
+| 10 | Valencià |
+| 11 | Polski - Polaco |
+| 12 | Galego |
+| 13 | Euskara |
+| 100 | български език - Bulgaro |
+| 156 | Chino |
+| 191 | Hrvatski - Croata |
+| 203 | Čeština - Checo |
+| 208 | Dansk - Danes |
+| 233 | Eesti keel - Estonio |
+| 246 | Suomi - Finlandes |
+| 300 | ελληνικά - Griego |
+| 348 | Magyar - Hungaro |
+| 392 | Japonés |
+| 428 | Latviešu valoda - Leton |
+| 440 | Lietuvių kalba - Lituano |
+| 470 | Malti - Maltés |
+| 642 | Română - Rumano |
+| 643 | ру́сский язы́к - Ruso |
+| 703 | Slovenský jazyk - Eslovaco |
+| 705 | Slovenski jezik - Esloveno |
+| 792 | Türkçe - Turco |

doc/Tabla DS_MERCHANT_CURRENCY.md

@@ -0,0 +1,223 @@
+# Tabla DS_MERCHANT_CURRENCY
+| CÓDIGO ISO | MONEDA |
+|------------|-|
+| 840 | DOLAR U.S.A. USD |
+| 826 | POUND STERLING GBP |
+| 392 | YEN JPY |
+| 32 | ARGENTINE AUSTRAL ARP |
+| 36 | AUSTRALIAN DOLLAR AUD |
+| 124 | CANADIAN DOLLAR CAD |
+| 152 | CHILEAN PESO CLP |
+| 170 | COLOMBIAN PESO COP |
+| 188 | COSTA RICA COLON CRC |
+| 356 | INDIAN RUPEE INR |
+| 484 | MEXICAN PESO MXP |
+| 604 | PERU INTI PEI |
+| 756 | SWISS FRANC CHF |
+| 858 | URUGUAYAN PESO UYP |
+| 986 | BRAZILIAN REAL BRL |
+| 949 | TURKISH LIRA TRY |
+| 8 | LEK ALL |
+| 12 | ALGERIAN DINAR DZD |
+| 24 | ANGOLA KWANZA AOK |
+| 30 | PROBANDO DESA MON |
+| 31 | AZERBAIJANIAN MANAT AZM |
+| 32 | ARGENTINE AUSTRAL ARP |
+| 36 | AUSTRALIAN DOLLAR AUD |
+| 44 | BAHAMIAN DOLLAR BSD |
+| 48 | BAHRAINI DINAR BHD |
+| 50 | TAKA BDT |
+| 51 | ARMENIAN DRAM AMD |
+| 52 | BARBADOS DOLLAR BBD |
+| 60 | BERMUDAN DOLLAR BMD |
+| 64 | NGULTRUM BTN |
+| 68 | BOLIVIAN PESO BOP |
+| 70 | DINAR BAD |
+| 72 | PULA BWP |
+| 76 | CRUZEIRO BRC |
+| 84 | BELIZE DOLLAR 084 |
+| 90 | SOLOMON ISLANDS DOLL SBD |
+| 96 | BRUNEI DOLLAR BND |
+| 100 | LEV BGL |
+| 104 | KYAT BUK |
+| 108 | BURUNDI FRANC BIF |
+| 112 | BELARUSSIAN RUBLE BYB |
+| 116 | RIEL KHR |
+| 124 | CANADIAN DOLLAR CAD |
+| 132 | CAPE VERDE ESCUDO CVE |
+| 136 | CAYMAN ISLANDS DOLLA KYD |
+| 144 | SRI LANKA RUPEE LKR |
+| 152 | CHILEAN PESO CLP |
+| 156 | YUAN RENMINBI CNY |
+| 157 | CHINESE RENMIMBI CNH |
+| 158 | CHINESE RENMINBI CNX |
+| 170 | COLOMBIAN PESO COP |
+| 174 | COMOROS FRANC KMF |
+| 180 | ZAIRE ZRZ |
+| 188 | COSTA RICA COLON CRC |
+| 191 | CROATIAN KUNA HRK |
+| 192 | CUBAN PESO CUP |
+| 196 | CYPRUS POUND CYP |
+| 200 | KORUNA CSK |
+| 203 | CZECH KORUNA CZK |
+| 208 | DANISH KRONE DKK |
+| 214 | DOMINICAN PESO DOP |
+| 218 | SUCRE ECS |
+| 222 | EL SALVADOR COLON SVC |
+| 226 | EKWELE GQE |
+| 230 | ETHIOPIAN BIRR ETB |
+| 232 | ERITREAN NAKTAN ERN |
+| 233 | ESTONIAN KROON EEK |
+| 238 | FALKLAND ISLANDS FKP |
+| 242 | FIJI DOLLAR FJD |
+| 262 | DJIBOUTI FRANC DJF |
+| 268 | GEORGIAN LARI GEL |
+| 270 | DALASI GMD |
+| 278 | MARK DER DDR DDM |
+| 288 | GHANA CEDI GHC |
+| 292 | GIBRALTAR POUND GIP |
+| 320 | QUETZAL GTQ |
+| 324 | SYLI GNS |
+| 328 | GUYANA DOLLAR GYD |
+| 332 | GOURDE HTG |
+| 340 | LEMPIRA HNL |
+| 344 | HONG KONG DOLLAR HKD |
+| 348 | FORINT HUF |
+| 352 | ICELAND KRONA ISK |
+| 356 | INDIAN RUPEE INR |
+| 360 | RUPIAH IDR |
+| 364 | IRANIAL RIAL IRR |
+| 365 | IRANIAN AIRLINE RATE IRA |
+| 368 | IRAQI DINAR IQD |
+| 376 | ISRAEL SHEKEL ILS |
+| 388 | JAMAICAN DOLLAR JMD |
+| 392 | YEN JPY |
+| 398 | TENGE KZT |
+| 400 | JORDANIAN DINAR JOD |
+| 404 | KENYAN SHILLING KES |
+| 408 | NORTH KOREAN WON KPW |
+| 410 | KOREAN WON KRW |
+| 414 | KUWAITI DINAR KWD |
+| 417 | KYRGYZSTAN SON KGS |
+| 418 | KIP LAK |
+| 422 | LEBANESE POUND LBP |
+| 426 | LESOTHO LOTI LSM |
+| 428 | LATVIAN LAT LVL |
+| 430 | LIBERIAN DOLLAR LRD |
+| 434 | LIBYAN DINAR LYD |
+| 440 | LITHUANIAN LITAS LTL |
+| 446 | PATACA MOP |
+| 450 | MALAGASY FRANC MGF |
+| 454 | MALAWI KWACHA MWK |
+| 458 | MALASYAN RINGGIT MYR |
+| 462 | MALDIVE RUPEE MVR |
+| 466 | MALI MLF |
+| 470 | MALTESE LIRA MTL |
+| 478 | OUGUIYA MRO |
+| 480 | MAURITIUS RUPEE MUR |
+| 484 | MEXICAN PESO MXP |
+| 496 | TUGRIK MNT |
+| 498 | MOLDOVIAN LEU MDL |
+| 504 | MORROCAN DIRHAM MAD |
+| 508 | METICAL MZM |
+| 512 | RIAL OMANI OMR |
+| 516 | NAMIBIAN DOLLAR NAD |
+| 524 | NEPALESE RUPEE NPR |
+| 532 | NETHERLANDS ANTILLIA ANG |
+| 533 | ARUBA AWG |
+| 536 | YUGOSLAVIAN NEW DIAN NTZ |
+| 548 | VANUATU VATU VUV |
+| 554 | NEW ZEALAND DOLLAR NZD |
+| 556 | NAIRA 566 |
+| 558 | CORDOBA NIC |
+| 566 | NAIRA NGN |
+| 578 | NORWEGIAN KRONE NOK |
+| 582 | PACIFIC ISLAND PCI |
+| 586 | PAKISTAN RUPEE PKR |
+| 590 | BALBOA PAB |
+| 598 | KINA PGK |
+| 600 | GUARANI PYG |
+| 604 | PERU INTI PEI |
+| 608 | PHILIPPINE PESO PHP |
+| 616 | ZLOTY PLZ |
+| 624 | GUINEA |
+| 626 | TIMOR ESCUDO TPE |
+| 634 | QATARI RIAL QAR |
+| 642 | LEU ROL |
+| 643 | RUSSIAN ROUBLE RUB |
+| 646 | RWANDA FRANC RWF |
+| 654 | ST.HELENA POUND SHP |
+| 678 | DOBRA STD |
+| 682 | SAUDI RIYAL SAR |
+| 690 | SEYCHELLES RUPEE SCR |
+| 694 | LEONE SLL |
+| 702 | SINGAPORE DOLLAR SGD |
+| 703 | SLOVAK KORUNA SKK |
+| 704 | DONG VND |
+| 705 | SLOVENIAN TOLAR SIT |
+| 706 | SOMALI SHILLING SOS |
+| 710 | RAND ZAR |
+| 716 | ZIMBABWE DOLLAR ZWD |
+| 720 | YEMENI DINAR YDD |
+| 728 | SOUTH SUDANESE POUND SSP |
+| 736 | SUDANESE POUND SDP |
+| 737 | SUDAN AIRLINES SDA |
+| 740 | SURINAM GUILDER SRG |
+| 748 | LILANGENI SZL |
+| 752 | SWEDISH KRONA SEK |
+| 756 | SWISS FRANC CHF |
+| 760 | SYRIAN POUND SYP |
+| 762 | TAJIK RUBLE TJR |
+| 764 | BAHT THB |
+| 776 | PA'ANGA TOP |
+| 780 | TRINIDAD Y TOBAGO DO TTD |
+| 784 | UAE DIRHAM AED |
+| 788 | TUNISIAN DINAR TND |
+| 792 | TURKISH LIRA TRL |
+| 793 | PSEUDO TURKISH LIRA PTL |
+| 795 | MANAT TMM |
+| 800 | UGANDA SHILLING UGS |
+| 804 | KARBOVANET UAK |
+| 807 | MACEDONIAN DENAR MKD |
+| 810 | RUSSIAN ROUBLE RUR |
+| 818 | EGYPTIAN POUND EGP |
+| 826 | POUND STERLING GBP |
+| 834 | TANZANIAN SHILLING TZS |
+| 840 | DOLAR U.S.A. USD |
+| 858 | URUGUAYAN PESO UYP |
+| 860 | UZBEKISTAN SUM UZS |
+| 862 | BOLIVAR VEB |
+| 882 | TALA WST |
+| 886 | YEMINI RIAL YER |
+| 890 | NEW YUGOSLAVIAN DOLL YUD |
+| 891 | NEW DINAR YUG |
+| 894 | KWACHA ZMK |
+| 901 | NEW TAIWAN DOLLAR TWD |
+| 934 | NEW MANAT TMT |
+| 936 | GHANA CEDI GHS |
+| 941 | DINAR SERBIO RSD |
+| 943 | MOZAMBIQUE METICAL MZN |
+| 944 | AZERBAIJANIAN MANAT AZN |
+| 946 | NEW LEU RON |
+| 949 | TURKISH LIRA TRY |
+| 950 | CFA FRANC BEAC XAF |
+| 951 | EAST CARIBBEAN DOLLA XCD |
+| 952 | CFA FRANC BCEAO XOF |
+| 953 | CFP FRANC XPF |
+| 954 | E.C.U. EUROPEAN CUR XEU |
+| 967 | KWACHA ZMW |
+| 968 | SURINAME DOLLAR SRD |
+| 969 | ARIARY MGA |
+| 971 | AFGHANISTAN AFGHANI AFN |
+| 972 | TAJIKISTAN SOMONI TJS |
+| 973 | KWANZA ANGOLA AOA |
+| 974 | BELARUSSIAN RUBLE BYR |
+| 975 | NEW LEV BGN |
+| 976 | FRANCO DEL CONGO CDF |
+| 977 | BOSNIAN MARKA BAM |
+| 978 | EURO EUR |
+| 980 | HRYVNIA UAH |
+| 981 | GEORGIAN LARI GEL |
+| 985 | NEW POLISH ZLOTY PLN |
+| 986 | BRAZILIAN REAL BRL |
+| 991 | RAND FINANCIER ZAL |

doc/Tabla DS_MERCHANT_PAYMETHODS.md

@@ -0,0 +1,9 @@
+# Tabla DS_MERCHANT_PAYMETHODS
+
+| FORMA DE PAGO | DS_MERCHANT_PAYMETHODS | DS_MERCHANT_TRANSACTIONTYPE | COMENTARIOS |
+|-|-|-|-|
+| BIZUM | z | 0, 7, 8 | Se requiere activación por parte de la entidad. |
+| PAYPAL | p | 0, 1, 15 | Se requiere activación por parte de la entidad. |
+| Transferencia | R | 0, 15, | Se requiere activación por parte de la entidad. |
+| Masterpass | N | 0, 7, 15, | Se requiere activación por parte de la entidad. |
+| Con Tarjeta | C | TODAS | |

doc/Tabla DS_MERCHANT_TRANSACTIONTYPE.md

@@ -0,0 +1,19 @@
+# Tabla DS_MERCHANT_TRANSACTIONTYPE
+|                TIPO DE OPERACIÓN               | DS_MERCHANT_TRANSACTIONSTYPE | ENTRADAS |
+|------------------------------------------------|----|----------------------------|
+| Autorización                                   |  0 | Redirección <br> REST/SOAP |
+| Preautorización                                |  1 | Redirección <br> REST/SOAP |
+| Preautorización de reemplazo                   | 11 | Redirección <br> REST/SOAP |
+| Confirmación                                   |  2 | Redirección <br> REST/SOAP |
+| Devolución                                     |  3 | Redirección <br> REST/SOAP |
+| Preautorización Separada                       |  7 | Redirección <br> REST/SOAP |
+| Confirmación Separada                          |  8 | Redirección <br> REST/SOAP |
+| Anulación                                      |  9 | Redirección <br> REST/SOAP |
+| Paygold                                        | 15 | Redirección <br> REST/SOAP |
+| Autenticación Puce                             | 17 | REST/SOAP |
+| Devolución sin original                        | 34 | Redirección <br> REST/SOAP |
+| Premio de apuestas                             | 37 | REST/SOAP |
+| Anulación de pago                              | 45 | Redirección <br> REST/SOAP |
+| Anulación de devolución                        | 46 | Redirección <br> REST/SOAP |
+| Anulación de confirmación separada             | 47 | Redirección <br> REST/SOAP |
+| Modificación de caducidad del enlace (Paygold) | 51 | Redirección <br> REST/SOAP |

doc/Tabla Ds_ProcessedPayMethod.md

@@ -0,0 +1,57 @@
+# Tabla Ds_ProcessedPayMethod
+
+Informa sobre el método en el que se ha realizado la operación:
+
+https://pagosonline.redsys.es/parametros-entrada-salida.html
+
+| Método de pago | Valor |
+|---------------:|-------|
+|   1 | Visa Secure
+|   3 | Tradicional Mundial
+|   5 | Finanet
+|  11 | Capacidad FINANET
+|  13 | Capacidad Visa Secure
+|  14 | Tradicional UE
+|  22 | MasterCard Identity Check
+|  23 | Capacidad Identity Check
+|  24 | Pago AMEX
+|  25 | Pago MOTO
+|  28 | Pago JCB
+|  31 | Pago DINERS
+|  39 | JCB JSecure
+|  40 | Capacidad JSecure
+|  41 | Domiciliacion
+|  42 | Transferencia
+|  54 | PayPal
+|  57 | SafeKey
+|  58 | Capacidad SafeKey
+|  59 | MasterPass Wallet
+|  68 | Bizum
+|  70 | UPI ExpressPay
+|  71 | GooglePay
+|  72 | ApplePay
+|  73 | UPI SecurePlus
+|  74 | Capacidad Discover
+|  75 | Discover ProtectBuy
+|  76 | Discover
+|  77 | Amazon Pay
+|  78 | Challenge Visa
+|  79 | Challenge MasterCard
+|  80 | Frictionless Visa
+|  81 | Frictionless MasterCard
+|  82 | Attempt Visa
+|  83 | Attempt MasterCard
+|  85 | Challenge Amex
+|  86 | Challenge Discover
+|  87 | Frictionless Amex
+|  88 | Frictionless Discover
+|  89 | Attempt Amex
+|  90 | Attempt Discover
+|  92 | Pago DINERS ProtectBuy
+|  93 | Challenge Diners ProtectBuy
+|  94 | Frictionless Diners ProtectBuy
+|  95 | Pago Attempt Diners ProtectBuy
+|  96 | Challenge JCB
+|  97 | Frictionless JCB
+|  98 | Attempt JCB
+| 107 | Pago con cuenta