From eed003597614219d84f4a9da8e3d32e699d35718 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Tue, 3 Sep 2024 12:51:33 -0500 Subject: [PATCH 01/11] feat: adds expiration date page --- src/assets/apis/checkout/en.yaml | 4 ++-- src/assets/apis/checkout/es.yaml | 4 ++-- src/constants/navigations.js | 8 ++++++++ src/pages/checkout/expiration.mdx | 26 ++++++++++++++++++++++++++ src/pages/en/checkout/expiration.mdx | 25 +++++++++++++++++++++++++ 5 files changed, 63 insertions(+), 4 deletions(-) create mode 100644 src/pages/checkout/expiration.mdx create mode 100644 src/pages/en/checkout/expiration.mdx diff --git a/src/assets/apis/checkout/en.yaml b/src/assets/apis/checkout/en.yaml index 88f72e5..139de80 100644 --- a/src/assets/apis/checkout/en.yaml +++ b/src/assets/apis/checkout/en.yaml @@ -3100,8 +3100,8 @@ components: format: date-time description: | Expiration date of a session. The user must finish the process before this date. - The expiration time must be at least 5 minutes from the time of creation. - e.g.: `2023-07-17T13:12:44-05:00` + The expiration time must be at least 5 minutes from the time of creation. See more in [Expiration date](/en/checkout/expiration) + e.g.: `2024-09-03T12:23:39-05:00` IpAddress: type: - string diff --git a/src/assets/apis/checkout/es.yaml b/src/assets/apis/checkout/es.yaml index c7fb14e..09db410 100644 --- a/src/assets/apis/checkout/es.yaml +++ b/src/assets/apis/checkout/es.yaml @@ -3101,8 +3101,8 @@ components: format: date-time description: | Fecha de expiración de una sesión. El usuario debe terminar el proceso antes de esta fecha. - El tiempo de expiración debe ser de al menos 5 minutos desde el momento de la creación. - EJ: `2023-07-17T13:12:44-05:00` + El tiempo de expiración debe ser de al menos 5 minutos desde el momento de la creación. Ver más en [Fecha de expiración](/checkout/expiration) + EJ: `2024-09-03T12:23:39-05:00` IpAddress: type: - string diff --git a/src/constants/navigations.js b/src/constants/navigations.js index 281c7ee..41d67f1 100644 --- a/src/constants/navigations.js +++ b/src/constants/navigations.js @@ -46,6 +46,10 @@ export const TAB_NAVIGATION = { title: 'Campos de procesamiento', href: '/checkout/processor-fields', }, + { + title: 'Fecha de expiración', + href: '/checkout/expiration', + }, ], }, ], @@ -123,6 +127,10 @@ export const TAB_NAVIGATION = { title: 'Processor Fields', href: '/checkout/processor-fields', }, + { + title: 'Expiration Date', + href: '/checkout/expiration', + }, ], }, ], diff --git a/src/pages/checkout/expiration.mdx b/src/pages/checkout/expiration.mdx new file mode 100644 index 0000000..bb6eacb --- /dev/null +++ b/src/pages/checkout/expiration.mdx @@ -0,0 +1,26 @@ +export const description = + 'La propiedad expiration se utiliza para definir el período durante el cual una sesión puede ser procesada' + +# Fecha de expiración + +Cuando se envía la propiedad `expiration` en la creación de una sesión esta define la fecha límite en la que una sesión debe completarse. El usuario debe finalizar el proceso antes de que se alcance esta fecha. + +- **Formato Requerido**: La propiedad expiration debe ser un string en formato de timestamp válido conforme al estándar `ISO 8601`. +Ejemplo: 2023-07-17T13:12:44-05:00. +- **Tiempo Mínimo**: La fecha y hora establecidas en expiration deben estar al menos a **5 minutos** después del momento en que se crea la sesión. + + +Nota: La propiedad expiration es opcional. Si no se proporciona, el sistema asignará automáticamente un tiempo de expiración predeterminado de **1 hora** desde la creación de la sesión. + + +```json +{ + "locale": "es_CO", + "auth": ... + "payment": { + ... + } + "expiration": "2024-09-03T12:23:39-05:00", + ... + } +``` \ No newline at end of file diff --git a/src/pages/en/checkout/expiration.mdx b/src/pages/en/checkout/expiration.mdx new file mode 100644 index 0000000..723b493 --- /dev/null +++ b/src/pages/en/checkout/expiration.mdx @@ -0,0 +1,25 @@ +export const description = + 'The expiration property is used to define the period during which a session can be processed' + +# Expiration Date +When the `expiration` property is sent during session creation, it defines the deadline by which a session must be completed. The user must finish the process before this date is reached. + +- **Required Format**: The expiration property must be a string in a valid timestamp format according to the `ISO 8601` standard. +Example: 2023-07-17T13:12:44-05:00. +- **Minimum Time**: The date and time specified in expiration must be at least **5 minutes** after the session is created. + + +Note: The `expiration` property is optional. If not provided, the system will automatically assign a default expiration time of **1 hour** from the session creation. + + +```json +{ + "locale": "es_CO", + "auth": ... + "payment": { + ... + } + "expiration": "2024-09-03T12:23:39-05:00", + ... + } +``` \ No newline at end of file From 90d6bdbf7c2f26007f1b32f5a3b34d4710d94b32 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Tue, 3 Sep 2024 13:15:02 -0500 Subject: [PATCH 02/11] Update expiration.mdx --- src/pages/checkout/expiration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/checkout/expiration.mdx b/src/pages/checkout/expiration.mdx index bb6eacb..7cd9785 100644 --- a/src/pages/checkout/expiration.mdx +++ b/src/pages/checkout/expiration.mdx @@ -10,7 +10,7 @@ Ejemplo: 2023-07-17T13:12:44-05:00. - **Tiempo Mínimo**: La fecha y hora establecidas en expiration deben estar al menos a **5 minutos** después del momento en que se crea la sesión. -Nota: La propiedad expiration es opcional. Si no se proporciona, el sistema asignará automáticamente un tiempo de expiración predeterminado de **1 hora** desde la creación de la sesión. +La propiedad expiration es opcional. Si no se proporciona, el sistema asignará automáticamente un tiempo de expiración predeterminado de **1 hora** desde la creación de la sesión. ```json From 21a84e7144a541caecbe26c5883a9c26bca72c69 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Tue, 3 Sep 2024 13:15:04 -0500 Subject: [PATCH 03/11] Update expiration.mdx --- src/pages/en/checkout/expiration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/en/checkout/expiration.mdx b/src/pages/en/checkout/expiration.mdx index 723b493..6cb2e99 100644 --- a/src/pages/en/checkout/expiration.mdx +++ b/src/pages/en/checkout/expiration.mdx @@ -9,7 +9,7 @@ Example: 2023-07-17T13:12:44-05:00. - **Minimum Time**: The date and time specified in expiration must be at least **5 minutes** after the session is created. -Note: The `expiration` property is optional. If not provided, the system will automatically assign a default expiration time of **1 hour** from the session creation. +The `expiration` property is optional. If not provided, the system will automatically assign a default expiration time of **1 hour** from the session creation. ```json From fa504fd70464120c3402ced0b171b6c612d78482 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Tue, 3 Sep 2024 13:55:20 -0500 Subject: [PATCH 04/11] docs: update checkout/changelog --- src/pages/checkout/api/changelog.mdx | 6 ++++++ src/pages/en/checkout/api/changelog.mdx | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/src/pages/checkout/api/changelog.mdx b/src/pages/checkout/api/changelog.mdx index df45fac..b18850e 100644 --- a/src/pages/checkout/api/changelog.mdx +++ b/src/pages/checkout/api/changelog.mdx @@ -10,6 +10,12 @@ Este archivo contiene las mejoras y actualizaciones que se hagan en Checkout API ... +## `2.22.0` 2024-09-05 + +### Nuevo: + + - La propiedad `payment.expiration` en el endpoint de creación de sesión ` /api/session` cambia de ser requerida a **opcional**. Si la fecha de expiración no se envía, se asignará automáticamente un valor predeterminado de `1 hora` a partir de la fecha de creación de la sesión. [Fecha de expiración](/checkout/expiration) + ## `2.21.9` 2024-07-26 ### Cambió: diff --git a/src/pages/en/checkout/api/changelog.mdx b/src/pages/en/checkout/api/changelog.mdx index 716a4ad..30dda6b 100644 --- a/src/pages/en/checkout/api/changelog.mdx +++ b/src/pages/en/checkout/api/changelog.mdx @@ -10,6 +10,12 @@ This file contains the improvements and updates made to the Checkout API. ... +## `2.22.0` 2024-09-05 + +### Added: + +- The `payment.expiration` property in the `/api/session` creation endpoint changes from being required to **optional**. If the expiration date is not provided, a default value of `1 hour ` from the session creation time will be automatically assigned. [Expiration date](/en/checkout/expiration) + ## `2.21.9` 2024-07-25 ### Changed: From 8355c8bdcf98428c3b81b1939f4c0c1bc015ea10 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Thu, 5 Sep 2024 11:17:08 -0500 Subject: [PATCH 05/11] update default expiration time to 30 minutes --- src/pages/checkout/api/changelog.mdx | 2 +- src/pages/checkout/expiration.mdx | 2 +- src/pages/en/checkout/api/changelog.mdx | 2 +- src/pages/en/checkout/expiration.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/pages/checkout/api/changelog.mdx b/src/pages/checkout/api/changelog.mdx index b18850e..af54ed8 100644 --- a/src/pages/checkout/api/changelog.mdx +++ b/src/pages/checkout/api/changelog.mdx @@ -14,7 +14,7 @@ Este archivo contiene las mejoras y actualizaciones que se hagan en Checkout API ### Nuevo: - - La propiedad `payment.expiration` en el endpoint de creación de sesión ` /api/session` cambia de ser requerida a **opcional**. Si la fecha de expiración no se envía, se asignará automáticamente un valor predeterminado de `1 hora` a partir de la fecha de creación de la sesión. [Fecha de expiración](/checkout/expiration) + - La propiedad `payment.expiration` en el endpoint de creación de sesión ` /api/session` cambia de ser requerida a **opcional**. Si la fecha de expiración no se envía, se asignará automáticamente un valor predeterminado de `30 minutos` a partir de la fecha de creación de la sesión. [Fecha de expiración](/checkout/expiration) ## `2.21.9` 2024-07-26 diff --git a/src/pages/checkout/expiration.mdx b/src/pages/checkout/expiration.mdx index 7cd9785..8a89fab 100644 --- a/src/pages/checkout/expiration.mdx +++ b/src/pages/checkout/expiration.mdx @@ -10,7 +10,7 @@ Ejemplo: 2023-07-17T13:12:44-05:00. - **Tiempo Mínimo**: La fecha y hora establecidas en expiration deben estar al menos a **5 minutos** después del momento en que se crea la sesión. -La propiedad expiration es opcional. Si no se proporciona, el sistema asignará automáticamente un tiempo de expiración predeterminado de **1 hora** desde la creación de la sesión. +La propiedad expiration es opcional. Si no se proporciona, el sistema asignará automáticamente un tiempo de expiración predeterminado de **30 minutes** desde la creación de la sesión. ```json diff --git a/src/pages/en/checkout/api/changelog.mdx b/src/pages/en/checkout/api/changelog.mdx index 30dda6b..85ca018 100644 --- a/src/pages/en/checkout/api/changelog.mdx +++ b/src/pages/en/checkout/api/changelog.mdx @@ -14,7 +14,7 @@ This file contains the improvements and updates made to the Checkout API. ### Added: -- The `payment.expiration` property in the `/api/session` creation endpoint changes from being required to **optional**. If the expiration date is not provided, a default value of `1 hour ` from the session creation time will be automatically assigned. [Expiration date](/en/checkout/expiration) +- The `payment.expiration` property in the `/api/session` creation endpoint changes from being required to **optional**. If the expiration date is not provided, a default value of `30 minutes` from the session creation time will be automatically assigned. [Expiration date](/en/checkout/expiration) ## `2.21.9` 2024-07-25 diff --git a/src/pages/en/checkout/expiration.mdx b/src/pages/en/checkout/expiration.mdx index 6cb2e99..d3bf812 100644 --- a/src/pages/en/checkout/expiration.mdx +++ b/src/pages/en/checkout/expiration.mdx @@ -9,7 +9,7 @@ Example: 2023-07-17T13:12:44-05:00. - **Minimum Time**: The date and time specified in expiration must be at least **5 minutes** after the session is created. -The `expiration` property is optional. If not provided, the system will automatically assign a default expiration time of **1 hour** from the session creation. +The `expiration` property is optional. If not provided, the system will automatically assign a default expiration time of **30 minutes** from the session creation. ```json From 51e7fbae8d5c91d6d81f9a2bd8b6645bf3615967 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Thu, 5 Sep 2024 19:26:11 -0500 Subject: [PATCH 06/11] Update changelog.mdx --- src/pages/checkout/api/changelog.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/checkout/api/changelog.mdx b/src/pages/checkout/api/changelog.mdx index af54ed8..e1a2f96 100644 --- a/src/pages/checkout/api/changelog.mdx +++ b/src/pages/checkout/api/changelog.mdx @@ -14,7 +14,7 @@ Este archivo contiene las mejoras y actualizaciones que se hagan en Checkout API ### Nuevo: - - La propiedad `payment.expiration` en el endpoint de creación de sesión ` /api/session` cambia de ser requerida a **opcional**. Si la fecha de expiración no se envía, se asignará automáticamente un valor predeterminado de `30 minutos` a partir de la fecha de creación de la sesión. [Fecha de expiración](/checkout/expiration) + - La propiedad `CreateSessionRequest.expiration` en el endpoint de creación de sesión ` /api/session` cambia de ser requerida a **opcional**. Si la fecha de expiración no se envía, se asignará automáticamente un valor predeterminado de `30 minutos` a partir de la fecha de creación de la sesión. [Fecha de expiración](/checkout/expiration) ## `2.21.9` 2024-07-26 From 6c16986103232239fab3bd39de8d31556c4683e0 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Thu, 5 Sep 2024 19:26:13 -0500 Subject: [PATCH 07/11] Update changelog.mdx --- src/pages/en/checkout/api/changelog.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/en/checkout/api/changelog.mdx b/src/pages/en/checkout/api/changelog.mdx index 85ca018..36fd460 100644 --- a/src/pages/en/checkout/api/changelog.mdx +++ b/src/pages/en/checkout/api/changelog.mdx @@ -14,7 +14,7 @@ This file contains the improvements and updates made to the Checkout API. ### Added: -- The `payment.expiration` property in the `/api/session` creation endpoint changes from being required to **optional**. If the expiration date is not provided, a default value of `30 minutes` from the session creation time will be automatically assigned. [Expiration date](/en/checkout/expiration) +- The `CreateSessionRequest.expiratio` property in the `/api/session` creation endpoint changes from being required to **optional**. If the expiration date is not provided, a default value of `30 minutes` from the session creation time will be automatically assigned. [Expiration date](/en/checkout/expiration) ## `2.21.9` 2024-07-25 From 348924844dce1d56b0d18e512dbe6f7a842c169a Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Thu, 5 Sep 2024 19:45:05 -0500 Subject: [PATCH 08/11] Update expiration.mdx --- src/pages/checkout/expiration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/checkout/expiration.mdx b/src/pages/checkout/expiration.mdx index 8a89fab..cc07486 100644 --- a/src/pages/checkout/expiration.mdx +++ b/src/pages/checkout/expiration.mdx @@ -3,7 +3,7 @@ export const description = # Fecha de expiración -Cuando se envía la propiedad `expiration` en la creación de una sesión esta define la fecha límite en la que una sesión debe completarse. El usuario debe finalizar el proceso antes de que se alcance esta fecha. +Cuando se envía la propiedad `CreateSessionRequest.expiration` en la creación de una sesión esta define la fecha límite en la que una sesión debe completarse. - **Formato Requerido**: La propiedad expiration debe ser un string en formato de timestamp válido conforme al estándar `ISO 8601`. Ejemplo: 2023-07-17T13:12:44-05:00. From 360369f8d3d72c63c9b55729d589a03108e0fb9d Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Thu, 5 Sep 2024 19:45:07 -0500 Subject: [PATCH 09/11] Update expiration.mdx --- src/pages/en/checkout/expiration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/en/checkout/expiration.mdx b/src/pages/en/checkout/expiration.mdx index d3bf812..795714c 100644 --- a/src/pages/en/checkout/expiration.mdx +++ b/src/pages/en/checkout/expiration.mdx @@ -2,7 +2,7 @@ export const description = 'The expiration property is used to define the period during which a session can be processed' # Expiration Date -When the `expiration` property is sent during session creation, it defines the deadline by which a session must be completed. The user must finish the process before this date is reached. +When the `CreateSessionRequest.expiration` property is sent during session creation, it defines the deadline by which a session must be completed. - **Required Format**: The expiration property must be a string in a valid timestamp format according to the `ISO 8601` standard. Example: 2023-07-17T13:12:44-05:00. From aeb96256843f3b735faccc6048aad8c64b529134 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Fri, 6 Sep 2024 11:44:00 -0500 Subject: [PATCH 10/11] Update changelog.mdx --- src/pages/checkout/api/changelog.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/checkout/api/changelog.mdx b/src/pages/checkout/api/changelog.mdx index e1a2f96..efac1ff 100644 --- a/src/pages/checkout/api/changelog.mdx +++ b/src/pages/checkout/api/changelog.mdx @@ -10,7 +10,7 @@ Este archivo contiene las mejoras y actualizaciones que se hagan en Checkout API ... -## `2.22.0` 2024-09-05 +## `2.22.0` 2024-09-10 ### Nuevo: From 4bd0055704365125c7fb6e7a9ed840e5cf1e7240 Mon Sep 17 00:00:00 2001 From: Ivan Andres L Date: Fri, 6 Sep 2024 11:44:02 -0500 Subject: [PATCH 11/11] Update changelog.mdx --- src/pages/en/checkout/api/changelog.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/en/checkout/api/changelog.mdx b/src/pages/en/checkout/api/changelog.mdx index 36fd460..8d72257 100644 --- a/src/pages/en/checkout/api/changelog.mdx +++ b/src/pages/en/checkout/api/changelog.mdx @@ -10,7 +10,7 @@ This file contains the improvements and updates made to the Checkout API. ... -## `2.22.0` 2024-09-05 +## `2.22.0` 2024-09-10 ### Added: