Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion docs/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -70,23 +70,41 @@ export default defineConfig({
'../open-payments-specifications/openapi/resource-server.yaml',
sidebar: { label: 'Open Payments' }
},
{
base: 'es/apis/resource-server',
schema:
'../open-payments-specifications/openapi/resource-server.yaml',
sidebar: { label: 'Open Payments' }
},
{
base: 'apis/wallet-address-server',
schema:
'../open-payments-specifications/openapi/wallet-address-server.yaml',
sidebar: { label: 'Wallet Addresses' }
},
{
base: 'es/apis/wallet-address-server',
schema:
'../open-payments-specifications/openapi/wallet-address-server.yaml',
sidebar: { label: 'Wallet Addresses' }
},
{
base: 'apis/auth-server',
schema: '../open-payments-specifications/openapi/auth-server.yaml',
sidebar: { label: 'Open Payments Authorization Server' }
},
{
base: 'es/apis/auth-server',
schema: '../open-payments-specifications/openapi/auth-server.yaml',
sidebar: { label: 'Open Payments Authorization Server' }
}
]),
starlightLinksValidator({
errorOnLocalLinks: false,
errorOnFallbackPages: false,
exclude: [
'/apis/{auth-server,resource-server,wallet-address-server}/**/*'
'/apis/{auth-server,resource-server,wallet-address-server}/**/*',
'/es/apis/{auth-server,resource-server,wallet-address-server}/**/*'
]
}),
starlightFullViewMode()
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/es/concepts/auth.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Una vez que el cliente avanzó en las secciones de pagos entrantes y cotizacione

En Open Payments, se exige que las solicitudes de concesiones de autorización para los pagos salientes sean interactivas. Esto significa que la interacción explícita de una persona (por lo general, el usuario del cliente) es un paso obligatorio en el proceso de delegación.

Luego de una interacción correcta, el cliente debe emitir una [solicitud de continuación de la concesión de autorización](/apis/auth-server/operations/post-continue), para que el servidor de autorización sepa que debe emitir un token de acceso.
Luego de una interacción correcta, el cliente debe emitir una [solicitud de continuación de la concesión de autorización](/es/apis/auth-server/operations/post-continue), para que el servidor de autorización sepa que debe emitir un token de acceso.

## Más información sobre la autorización

Expand Down
16 changes: 8 additions & 8 deletions docs/src/content/docs/es/concepts/op-flow.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ En esta página, se analizan en profundidad las llamadas e interacciones de la i

## Cómo obtener los datos de la cuenta

Un cliente recupera los datos públicos sobre la cuenta compatible con Open Payments de un destinatario mediante la emisión de una <LinkOut href='/apis/wallet-address-server/operations/get-wallet-address/'>solicitud GET</LinkOut> para la dirección de billetera del destinatario. Los datos incluyen el código y la escala del activo de la cuenta subyacente, así como las URL de los servidores de autorización y de recursos que el cliente necesita para configurar un pago al destinatario.
Un cliente recupera los datos públicos sobre la cuenta compatible con Open Payments de un destinatario mediante la emisión de una <LinkOut href='/es/apis/wallet-address-server/operations/get-wallet-address/'>solicitud GET</LinkOut> para la dirección de billetera del destinatario. Los datos incluyen el código y la escala del activo de la cuenta subyacente, así como las URL de los servidores de autorización y de recursos que el cliente necesita para configurar un pago al destinatario.

<MermaidWrapper diagramName="get-account-details">

Expand All @@ -42,7 +42,7 @@ Un cliente recupera los datos públicos sobre la cuenta compatible con Open Paym

## Pago entrante

Primero, el cliente <LinkOut href='/apis/auth-server/operations/post-request'>solicita/recibe una concesión de autorización</LinkOut> de parte del servidor de autorización de la <Tooltip content="Entidad que administra la cuenta" client:load>ASE</Tooltip> del destinatario para crear un recurso de `incoming-payment`. El cliente envía una solicitud al servidor de recursos de la ASE para <LinkOut href='/apis/resource-server/operations/create-incoming-payment/'>crear el recurso</LinkOut>. Una vez creado, el servidor de recursos devuelve los datos de pago único que el cliente utilizará para realizar uno o más pagos al destinatario.
Primero, el cliente <LinkOut href='/es/apis/auth-server/operations/post-request'>solicita/recibe una concesión de autorización</LinkOut> de parte del servidor de autorización de la <Tooltip content="Entidad que administra la cuenta" client:load>ASE</Tooltip> del destinatario para crear un recurso de `incoming-payment`. El cliente envía una solicitud al servidor de recursos de la ASE para <LinkOut href='/es/apis/resource-server/operations/create-incoming-payment/'>crear el recurso</LinkOut>. Una vez creado, el servidor de recursos devuelve los datos de pago único que el cliente utilizará para realizar uno o más pagos al destinatario.

<MermaidWrapper diagramName="incoming-payment">

Expand All @@ -64,7 +64,7 @@ Primero, el cliente <LinkOut href='/apis/auth-server/operations/post-request'>so

## Cotización

El cliente <LinkOut href='/apis/auth-server/operations/post-request'>solicita/recibe una concesión de autorización</LinkOut> de parte del servidor de autorización de la <Tooltip content="Entidad que administra la cuenta" client: load><span>ASE</span></Tooltip> del destinatario, para crear un recurso de `quote`. El cliente envía una solicitud al servidor de recursos para <LinkOut href='/apis/resource-server/operations/create-quote'>crear el recurso</LinkOut>. Una vez creado, el servidor de recursos devuelve, entre otros datos, una `id` de cotización y el monto que costará efectuar el pago.
El cliente <LinkOut href='/es/apis/auth-server/operations/post-request'>solicita/recibe una concesión de autorización</LinkOut> de parte del servidor de autorización de la <Tooltip content="Entidad que administra la cuenta" client: load><span>ASE</span></Tooltip> del destinatario, para crear un recurso de `quote`. El cliente envía una solicitud al servidor de recursos para <LinkOut href='/es/apis/resource-server/operations/create-quote'>crear el recurso</LinkOut>. Una vez creado, el servidor de recursos devuelve, entre otros datos, una `id` de cotización y el monto que costará efectuar el pago.

<MermaidWrapper diagramName="quote">

Expand All @@ -86,19 +86,19 @@ El cliente <LinkOut href='/apis/auth-server/operations/post-request'>solicita/re

## Pago saliente

Antes de que se pueda crear un recurso de pago saliente en la cuenta del remitente, Open Payments exige que el cliente envíe una <LinkOut href='/apis/auth-server/operations/post-request'>solicitud interactiva de concesión de autorización</LinkOut> al servidor de autorización de la <Tooltip content="Entidad que administra la cuenta" client: load><span>ASE</span></Tooltip> del remitente.
Antes de que se pueda crear un recurso de pago saliente en la cuenta del remitente, Open Payments exige que el cliente envíe una <LinkOut href='/es/apis/auth-server/operations/post-request'>solicitud interactiva de concesión de autorización</LinkOut> al servidor de autorización de la <Tooltip content="Entidad que administra la cuenta" client: load><span>ASE</span></Tooltip> del remitente.

Una solicitud interactiva de concesión de autorización exige que se obtenga el consentimiento explícito del remitente antes de que se emita un token de acceso. Aunque el cliente debe facilitar la interacción, el servidor de autorización y el proveedor de identidad (identity provider, IdP) de la ASE del remitente son responsables de la interfaz y de obtener el consentimiento.

Una vez que se obtuvo el consentimiento, el cliente solicita permiso para <LinkOut href='/apis/auth-server/operations/post-continue'>continuar con la solicitud de concesión de autorización</LinkOut> con el fin de obtener un token de acceso.
Una vez que se obtuvo el consentimiento, el cliente solicita permiso para <LinkOut href='/es/apis/auth-server/operations/post-continue'>continuar con la solicitud de concesión de autorización</LinkOut> con el fin de obtener un token de acceso.

:::note[Cronograma de la solicitud de continuación]
Para los pagos salientes, se requiere el consentimiento explícito del usuario antes de avanzar con la solicitud de continuación. Una vez que el usuario completó su interacción con el proveedor de identidad (IdP), debe ser redirigido de vuelta a la aplicación. En este punto, usted puede hacer la solicitud de continuación de la concesión. En situaciones donde una interfaz de usuario no se encuentra disponible, analice la posibilidad de implementar un mecanismo de sondeo para verificar que se haya completado la interacción.
:::

<Interactive />

Una vez que se obtiene un token de acceso, el cliente puede solicitar la creación de un <LinkOut href='/apis/resource-server/operations/create-outgoing-payment'>recurso de pago saliente</LinkOut>. La configuración del pago está completa, y el flujo de Open Payments finaliza luego de la creación del recurso.
Una vez que se obtiene un token de acceso, el cliente puede solicitar la creación de un <LinkOut href='/es/apis/resource-server/operations/create-outgoing-payment'>recurso de pago saliente</LinkOut>. La configuración del pago está completa, y el flujo de Open Payments finaliza luego de la creación del recurso.

<MermaidWrapper diagramName="outgoing-payment">

Expand All @@ -118,7 +118,7 @@ Una vez que se obtiene un token de acceso, el cliente puede solicitar la creaci

## Cómo obtener el historial de transacciones

Para proporcionar a un usuario el historial de sus transacciones, el cliente puede recuperar una lista de los <LinkOut href='/apis/resource-server/operations/list-incoming-payments/'>pagos entrantes (recibidos)</LinkOut> y los <LinkOut href='/apis/resource-server/operations/list-outgoing-payments/'>pagos salientes (enviados)</LinkOut> del usuario.
Para proporcionar a un usuario el historial de sus transacciones, el cliente puede recuperar una lista de los <LinkOut href='/es/apis/resource-server/operations/list-incoming-payments/'>pagos entrantes (recibidos)</LinkOut> y los <LinkOut href='/es/apis/resource-server/operations/list-outgoing-payments/'>pagos salientes (enviados)</LinkOut> del usuario.

<MermaidWrapper diagramName="get-all-transaction-history">

Expand All @@ -136,7 +136,7 @@ Para proporcionar a un usuario el historial de sus transacciones, el cliente pue

</MermaidWrapper>

De igual manera, el cliente puede proporcionar al usuario los datos sobre un pago <LinkOut href='/apis/resource-server/operations/get-incoming-payment'>entrante</LinkOut> o <LinkOut href='/apis/resource-server/operations/get-outgoing-payment'>saliente</LinkOut> en específico.
De igual manera, el cliente puede proporcionar al usuario los datos sobre un pago <LinkOut href='/es/apis/resource-server/operations/get-incoming-payment'>entrante</LinkOut> o <LinkOut href='/es/apis/resource-server/operations/get-outgoing-payment'>saliente</LinkOut> en específico.

<MermaidWrapper diagramName="get-specific-transaction-history">

Expand Down
4 changes: 2 additions & 2 deletions docs/src/content/docs/es/concepts/resources.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ En lugar de especificar el monto que se recibirá, puede especificar la cantidad

El pago saliente se crea y los fondos se envían al recurso de `incoming-payment`. Sin embargo, el `incomingAmount` nunca se estableció, por lo que el destinatario no tiene forma de saber qué monto recibirá. La ASE del destinatario no sabrá cuando se haya completado el pago.

En lugar de esperar hasta el vencimiento de la sesión de pago, el cliente puede emitir una solicitud explícita para <LinkOut href='/apis/resource-server/operations/complete-incoming-payment'>completar el pago entrante</LinkOut> de forma manual, con el fin de indicar que no se enviarán más pagos.
En lugar de esperar hasta el vencimiento de la sesión de pago, el cliente puede emitir una solicitud explícita para <LinkOut href='/es/apis/resource-server/operations/complete-incoming-payment'>completar el pago entrante</LinkOut> de forma manual, con el fin de indicar que no se enviarán más pagos.

:::tip[Caso de uso: pagos continuos mediante Web Monetization (estándar de monetización web)]
En los pagos continuos por medio de Web Monetization, la ASE del destinatario desconoce el monto máximo que se va a pagar. Los pagos siguen efectuándose hasta que el agente de Web Monetization finaliza la sesión. En este punto, el agente de Web Monetization puede solicitar que se marque como completado el pago entrante. Esto permite que la ASE del destinatario sea notificada lo antes posible de que no se enviarán más pagos y que se acredite el monto en la cuenta del destinatario.
Expand All @@ -45,7 +45,7 @@ El objetivo de una cotización es indicar cuánto costará efectuar el pago, lo

Existen tres tipos de cotizaciones:

- **Cotización de envío fijo:** se pagará un monto fijo desde la cuenta del _remitente_. Se exige un `debitAmount` para este tipo de cotización. En este caso, un pago entrante no puede completarse automáticamente hasta su vencimiento. Sin embargo, en lugar de esperar hasta su vencimiento, el cliente puede emitir una <LinkOut href='/apis/resource-server/operations/complete-incoming-payment'>solicitud de completar el pago entrante</LinkOut> una vez que el pago saliente se haya completado.
- **Cotización de envío fijo:** se pagará un monto fijo desde la cuenta del _remitente_. Se exige un `debitAmount` para este tipo de cotización. En este caso, un pago entrante no puede completarse automáticamente hasta su vencimiento. Sin embargo, en lugar de esperar hasta su vencimiento, el cliente puede emitir una <LinkOut href='/es/apis/resource-server/operations/complete-incoming-payment'>solicitud de completar el pago entrante</LinkOut> una vez que el pago saliente se haya completado.
- **Cotización de recepción fija:** se pagará un monto fijo en la cuenta del _destinatario_. Se exige un `receiveAmount` para este tipo de cotización.
- **Cotización con monto entrante:** el pago entrante ya tiene un `incomingAmount` definido. Para este tipo de cotización, el `receiver` es la URL del recurso de `incoming-payment` a la que se efectuará el pago, que se indica por la presencia de `/incoming-payments` en la URL.

Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/es/concepts/wallet-addresses.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Content-Type: application/json

Al configurar un pago, el cliente debe obtener la dirección de billetera tanto del remitente como del destinatario. Dado que el remitente, por lo general, es el usuario del cliente, el cliente puede obtener su dirección de billetera, por ejemplo, durante el proceso de incorporación. La entidad que administra la cuenta (account servicing entity, ASE) debe autenticar al remitente para concederle el permiso que necesita para acceder a su cuenta compatible con Open Payments.

Un servidor de direcciones de billetera es el punto final de una API que recupera información pública sobre una dirección de billetera, lo que incluye sus claves públicas asociadas. Para obtener más información técnica, visite los [documentos de la API del servidor de direcciones de billetera](/apis/wallet-address-server/operations/get-wallet-address/).
Un servidor de direcciones de billetera es el punto final de una API que recupera información pública sobre una dirección de billetera, lo que incluye sus claves públicas asociadas. Para obtener más información técnica, visite los [documentos de la API del servidor de direcciones de billetera](/es/apis/wallet-address-server/operations/get-wallet-address/).

## Privacidad y seguridad

Expand Down
10 changes: 5 additions & 5 deletions docs/src/content/docs/es/guides/make-onetime-payment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,11 @@ En esta guía, encontrará los pasos que debe seguir para efectuar un pago únic

## Puntos finales

- <LinkOut href='https://openpayments.dev/apis/auth-server/operations/post-request/'>Solicitud de concesiones de autorización</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/wallet-address-server/operations/get-wallet-address/'>Cómo obtener una dirección de billetera</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/resource-server/operations/create-incoming-payment/'>Cómo crear un pago entrante</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/resource-server/operations/create-quote/'>Cómo crear una cotización</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/resource-server/operations/create-outgoing-payment/'>Cómo crear un pago saliente</LinkOut>
- <LinkOut href='/es/apis/auth-server/operations/post-request/'>Solicitud de concesiones de autorización</LinkOut>
- <LinkOut href='/es/apis/wallet-address-server/operations/get-wallet-address/'>Cómo obtener una dirección de billetera</LinkOut>
- <LinkOut href='/es/apis/resource-server/operations/create-incoming-payment/'>Cómo crear un pago entrante</LinkOut>
- <LinkOut href='/es/apis/resource-server/operations/create-quote/'>Cómo crear una cotización</LinkOut>
- <LinkOut href='/es/apis/resource-server/operations/create-outgoing-payment/'>Cómo crear un pago saliente</LinkOut>

<Tabs>
<TabItem label='TypeScript'>
Expand Down
12 changes: 6 additions & 6 deletions docs/src/content/docs/es/guides/make-recurring-payments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ En esta guía, encontrará pasos para realizar pagos recurrentes, en los que una

## Puntos finales

- <LinkOut href='https://openpayments.dev/apis/auth-server/operations/post-request/'>Solicitud de concesiones de autorización</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/wallet-address-server/operations/get-wallet-address/'>Cómo obtener una dirección de billetera</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/resource-server/operations/create-incoming-payment/'>Cómo crear un pago entrante</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/resource-server/operations/create-quote/'>Cómo crear una cotización</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/resource-server/operations/create-outgoing-payment/'>Cómo crear un pago saliente</LinkOut>
- <LinkOut href='https://openpayments.dev/apis/auth-server/operations/post-token/'>Cómo rotar un token de acceso</LinkOut>
- <LinkOut href='/es/apis/auth-server/operations/post-request/'>Solicitud de concesiones de autorización</LinkOut>
- <LinkOut href='/es/apis/wallet-address-server/operations/get-wallet-address/'>Cómo obtener una dirección de billetera</LinkOut>
- <LinkOut href='/es/apis/resource-server/operations/create-incoming-payment/'>Cómo crear un pago entrante</LinkOut>
- <LinkOut href='/es/apis/resource-server/operations/create-quote/'>Cómo crear una cotización</LinkOut>
- <LinkOut href='/es/apis/resource-server/operations/create-outgoing-payment/'>Cómo crear un pago saliente</LinkOut>
- <LinkOut href='/es/apis/auth-server/operations/post-token/'>Cómo rotar un token de acceso</LinkOut>

<Tabs>
<TabItem label='TypeScript'>
Expand Down
Loading