@@ -70,70 +70,102 @@ Una vez que se ha instalado la SDK, se deben actualizar los parámetros de confi
7070*  Credenciales de acceso (Se gestionan con el departamento de integraciones de Sipay).
7171*  Entorno y versión de la API.
7272*  Tiempo máximo de espera de respuestas (Timeout).
73+ ## 4.1. Desde un fichero  
74+ 
75+   Un ejemplo de configuraciones se muestra a continuación:
76+   ``` ini 
77+   ;  **************************************************************
78+   ;  LOGGER
79+   ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
80+   ;  Configuración asociada al sistema de trazas.
81+   ; 
82+   ;  path: ruta del directorio de logs (Nota: Aconsejable usar rutas absolutas, en caso contrario los logs estaran dentro del paquete)
83+   ;  level: nivel mínimo de trazas [debug, info, warning, error, critical]
84+   ;  prefix: prefijo
85+   ;  extension: extensión del archivo
86+   ;  date_format: formato de fecha de las trazas
87+   ;  backup_file_rotation: Número de ficheros de backup
88+   ;  ------------------------------------------------------------//
89+ 
90+   [logger]
91+   path =logs
92+   level =warning
93+   prefix =logger
94+   extension =log
95+   date_format =d/m/Y H:i:s
96+   backup_file_rotation  = 5
97+ 
98+   ;  **************************************************************
99+   ;  CREDENTIALS
100+   ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
101+   ;  Credenciales para obtener acceso al recurso.
102+   ; 
103+   ;  key: Key del cliente
104+   ;  secret: Secret del cliente
105+   ;  resouce: Recurso al que se quiere acceder
106+   ;  ------------------------------------------------------------//
107+ 
108+   [credentials]
109+   key =api-key
110+   secret =api-secret
111+   resource =resource
112+ 
113+   ;  **************************************************************
114+   ;  API
115+   ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
116+   ;  Configuracion de la API.
117+   ; 
118+   ;  environment: Entorno al que se deben enviar las peticiones ['sandbox', 'staging', 'live']
119+   ;  version: Versión de la api a usar actualmente solo existe v1
120+   ;  mode: Modo de encriptacion de la firma, [sha256, sha512]
121+   ;  ------------------------------------------------------------//
122+ 
123+   [api]
124+   environment =sandbox
125+   version =v1
126+   mode =sha256
127+ 
128+   ;  **************************************************************
129+   ;  Connection
130+   ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
131+   ;  Cofiguracion de la conexión.
132+   ; 
133+   ;  timeout: Tiempo máximo de espera a la respuesta de la petición
134+   ;  ------------------------------------------------------------//
135+ 
136+   [connection]
137+   timeout =30
138+   ``` 
139+ 
140+ ## 4.2. Desde una variable  
141+ En algunos casos, pudiera interesarnos cargar la configuración desde una variable y no desde un archivo. Este sería un ejemplo:
142+ 
143+ ``` php 
144+   <?php
145+   $config = array(
146+       'logger' => array(
147+           'path' => 'logs',  // Nombre del directorio donde se crearan los logs (Nota: si la ruta es relativa se creará en el directorio del paquete)
148+           'level' => 'warning',  // Nivel mínimo de trazas [debug, info, warning, error, critical]
149+           'prefix' => 'logger',  // Prefijo del nombre del archivo
150+           'extension' => 'log',  // Extensión del archivo
151+           'date_format' => 'd/m/Y H:i:s',  // Formato de fecha de las trazas de log
152+           'backup_file_rotation' => 5  // Número de ficheros de backup
153+       ),
154+       'credentials' => array(
155+           'key' => 'api-key',  // Key del cliente
156+           'secret' => 'api-secret',  // Secret del cliente
157+           'resource' => 'resource' // Recurso al que se quiere acceder
158+       ),
159+       'api' => array(
160+           'environment' => 'sandbox',  // Entorno al que se deben enviar las peticiones ['sandbox', 'staging', 'live']
161+           'version' => 'v1',  // Versión de la api a usar actualmente solo existe v1
162+           'mode' => 'sha256'  // Modo de encriptacion de la firma, [sha256, sha512]
163+       ),
164+       'connection' => array(
165+           'timeout' => 30  // Tiempo máximo de respuesta de la petición.
166+       )
167+   );
73168
74- Un ejemplo de configuraciones se muestra a continuación:
75- ``` ini 
76- ;  **************************************************************
77- ;  LOGGER
78- ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
79- ;  Configuración asociada al sistema de trazas.
80- ; 
81- ;  path: ruta del directorio de logs (Nota: Aconsejable usar rutas absolutas, en caso contrario los logs estaran dentro del paquete)
82- ;  level: nivel minimo de trazas [debug, info, warning, error, critical]
83- ;  prefix: prefijo
84- ;  extension: extensión del archivo
85- ;  date_format: formato de fecha de las trazas
86- ;  backup_file_rotation: Número de ficheros de backup
87- ;  ------------------------------------------------------------//
88- 
89- [logger] 
90- path =logs
91- level =warning
92- prefix =logger
93- extension =log
94- date_format =d/m/Y H:i:s
95- backup_file_rotation  = 5
96- 
97- ;  **************************************************************
98- ;  CREDENTIALS
99- ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
100- ;  Credenciales para obtener acceso al recurso.
101- ; 
102- ;  key: Key del cliente
103- ;  secret: Secret del cliente
104- ;  resouce: Recurso al que se quiere acceder
105- ;  ------------------------------------------------------------//
106- 
107- [credentials] 
108- key =api-key
109- secret =api-secret
110- resource =resource
111- 
112- ;  **************************************************************
113- ;  API
114- ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
115- ;  Configuracion de la API.
116- ; 
117- ;  environment: Entorno al que se deben enviar las peticiones ['sandbox', 'staging', 'live']
118- ;  version: Versión de la api a usar actualmente solo existe v1
119- ;  mode: Modo de encriptacion de la firma, [sha256, sha512]
120- ;  ------------------------------------------------------------//
121- 
122- [api] 
123- environment =sandbox
124- version =v1
125- mode =sha256
126- 
127- ;  **************************************************************
128- ;  Connection
129- ;  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
130- ;  Cofiguracion de la conexión.
131- ; 
132- ;  timeout: Tiempo máximo de espera a la respuesta de la petición
133- ;  ------------------------------------------------------------//
134- 
135- [connection] 
136- timeout =30
137169``` 
138170
139171# 5. Documentación extendida  
@@ -293,7 +325,7 @@ Ejemplo:
293325  $card = new \Sipay\Paymethods\FastPay('token-fast-pay');
294326``` 
295327
296- ## 5.2. Operativas de Ecommerce - ` Ecommerce($config_file) `   
328+ ## 5.2. Operativas de Ecommerce - ` Ecommerce($config_file) `  ó  ` Ecommerce($config_var) `   
297329
298330#### Descripción  
299331Las operativas de Ecommerce forman parte de los métodos definidos en la clase ` Ecommerce ` . Para instanciar un objeto de este tipo se requiere el archivo de configuración.
0 commit comments