docs: adding es-translated pages #678
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
✅ Deploy Preview for openpayments-preview ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
I suspect the issues are due to a combo of "it" not liking lists beginning with the linkout component and Blair's change to prettier yesterday
melissahenderson
requested review from
JoblersTune and
Anca2022
and removed request for
hajjimo and
brad-dow
marianvilla
reviewed
Sep 5, 2025
|
Could we get the landing page translated too? To get a better first impression? |
JoblersTune
reviewed
Sep 8, 2025
|
|
||
| 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. |
There was a problem hiding this comment.
Suggested change
| 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. |
There was a problem hiding this comment.
@JoblersTune I don't think the API specs will ever be translated outside of English. Is it still a good idea to point to a lang folder?
|
|
||
| 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/). |
There was a problem hiding this comment.
Suggested change
| 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/). |
|
|
||
| ### 1. Obtener los datos de la dirección de billetera | ||
|
|
||
| Supongamos que su usuario guardó su dirección de billetera en el perfil de su cuenta al configurar la aplicación. Llame a la [API Obtener dirección de billetera](/apis/wallet-address-server/operations/get-wallet-address) para obtener los datos necesarios sobre la cuenta de la billetera del usuario. |
There was a problem hiding this comment.
Suggested change
| Supongamos que su usuario guardó su dirección de billetera en el perfil de su cuenta al configurar la aplicación. Llame a la [API Obtener dirección de billetera](/apis/wallet-address-server/operations/get-wallet-address) para obtener los datos necesarios sobre la cuenta de la billetera del usuario. | |
| Supongamos que su usuario guardó su dirección de billetera en el perfil de su cuenta al configurar la aplicación. Llame a la [API Obtener dirección de billetera](/es/apis/wallet-address-server/operations/get-wallet-address) para obtener los datos necesarios sobre la cuenta de la billetera del usuario. |
|
|
||
| ### 2. Solicitar una concesión de autorización interactiva para un pago saliente | ||
|
|
||
| Utilice la información del servidor de autorización recibida en el paso anterior para llamar a la [API Solicitud de concesión](/apis/auth-server/operations/post-request). El propósito de esta llamada consiste en obtener un token que permita que el cliente solicite la creación de recursos de pago saliente en la cuenta de la billetera de su usuario. |
There was a problem hiding this comment.
Suggested change
| Utilice la información del servidor de autorización recibida en el paso anterior para llamar a la [API Solicitud de concesión](/apis/auth-server/operations/post-request). El propósito de esta llamada consiste en obtener un token que permita que el cliente solicite la creación de recursos de pago saliente en la cuenta de la billetera de su usuario. | |
| Utilice la información del servidor de autorización recibida en el paso anterior para llamar a la [API Solicitud de concesión](/es/apis/auth-server/operations/post-request). El propósito de esta llamada consiste en obtener un token que permita que el cliente solicite la creación de recursos de pago saliente en la cuenta de la billetera de su usuario. |
|
|
||
| ### 6. Solicitar una concesión de autorización interactiva para un pago saliente | ||
|
|
||
| Utilice la información del consumidor `authServer` recibida en el paso 1 para llamar a la [API Solicitud de concesión](/apis/auth-server/operations/post-request). |
There was a problem hiding this comment.
Suggested change
| Utilice la información del consumidor `authServer` recibida en el paso 1 para llamar a la [API Solicitud de concesión](/apis/auth-server/operations/post-request). | |
| Utilice la información del consumidor `authServer` recibida en el paso 1 para llamar a la [API Solicitud de concesión](/es/apis/auth-server/operations/post-request). |
| En una situación hipotética 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. | ||
| ::: | ||
|
|
||
| Llame a la [API Continuación de solicitud de concesión](/apis/auth-server/operations/post-continue). El propósito de esta llamada consiste en solicitar un token de acceso que permita a su plataforma solicitar la creación de recursos de pago saliente en la cuenta de la billetera del consumidor. |
There was a problem hiding this comment.
Suggested change
| Llame a la [API Continuación de solicitud de concesión](/apis/auth-server/operations/post-continue). El propósito de esta llamada consiste en solicitar un token de acceso que permita a su plataforma solicitar la creación de recursos de pago saliente en la cuenta de la billetera del consumidor. | |
| Llame a la [API Continuación de solicitud de concesión](/es/apis/auth-server/operations/post-continue). El propósito de esta llamada consiste en solicitar un token de acceso que permita a su plataforma solicitar la creación de recursos de pago saliente en la cuenta de la billetera del consumidor. |
|
|
||
| Dado que las cotizaciones contienen los montos por debitar y recibir, no especificaremos otros montos al realizar una solicitud a la API Crear pago saliente. En su lugar, especificaremos un `quoteId`. | ||
|
|
||
| Utilice los tókenes de acceso devueltos en el paso 5 para llamar a la [API Crear pago saliente](/apis/resource-server/operations/create-outgoing-payment). |
There was a problem hiding this comment.
Suggested change
| Utilice los tókenes de acceso devueltos en el paso 5 para llamar a la [API Crear pago saliente](/apis/resource-server/operations/create-outgoing-payment). | |
| Utilice los tókenes de acceso devueltos en el paso 5 para llamar a la [API Crear pago saliente](/es/apis/resource-server/operations/create-outgoing-payment). |
docs/astro.config.mjs
Outdated
There was a problem hiding this comment.
We can keep the APIs in the Spanish navigation like so:
starlightOpenAPI([
{
base: 'apis/resource-server',
schema:
'../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' }
}
]),
Anca2022
reviewed
Sep 8, 2025
| {/* prettier-ignore */} | ||
| <Mermaid | ||
| graph={`sequenceDiagram autonumber | ||
| Cliente->>Servidor de autorización (Authorization server AS): solicitud POST de concesión de autorización (con objeto de interacción) |
There was a problem hiding this comment.
Phrases on the diagram should begin with a capital letter for consistency with the other diagrams.
Anca2022
reviewed
Sep 8, 2025
Anca2022
reviewed
Sep 8, 2025
Anca2022
reviewed
Sep 8, 2025
Anca2022
reviewed
Sep 8, 2025
Anca2022
reviewed
Sep 8, 2025
Anca2022
reviewed
Sep 8, 2025
|
|
||
| El ejemplo a continuación ilustra cómo crear la firma, comenzando con el mensaje HTTP original. | ||
|
|
||
| ```http title="Example: message before signature" |
There was a problem hiding this comment.
title="Example: message before signature" in spanish
Anca2022
reviewed
Sep 8, 2025
|
|
||
| El subcampo final de la base de la firma es un campo estructurado HTTP llamado `signature-params`, que contiene una lista ordenada de los componentes que conforman la base de la firma. | ||
|
|
||
| ```http wrap title="Example: signature base" |
There was a problem hiding this comment.
title="Example: signature base" in spanish
Anca2022
reviewed
Sep 8, 2025
|
|
||
| El mensaje original se firma agregando encabezados de firma con etiquetas exclusivas al mensaje original: `Signature-Input` y `Signature`. | ||
|
|
||
| ```http wrap title="Example: signed message" |
There was a problem hiding this comment.
title="Example: signed message" in spanish
Anca2022
reviewed
Sep 8, 2025
|
|
||
| El ejemplo a continuación muestra los cuatro componentes mencionados que conforman la base del hash. No se admite relleno ni espacios en blanco antes o después de cada línea, ni un salto de línea adicional al final. | ||
|
|
||
| ```http title="Example hash base" |
There was a problem hiding this comment.
title="Example hash base" in spanish
Anca2022
reviewed
Sep 8, 2025
|
|
||
| El ejemplo a continuación muestra cómo verificar en JavaScript el hash recibido del servidor de autorización. | ||
|
|
||
| ```javascript title='JavaScript example' |
There was a problem hiding this comment.
title "Javascript example" in spanish
Anca2022
reviewed
Sep 8, 2025
|
|
||
| Con el ejemplo de la cadena base de hash mencionado, a continuación se muestra el hash codificado `sha-256` que usa el algoritmo SHA2 de 256 bits. | ||
|
|
||
| ```http title="SHA2 256-bit hash example" |
There was a problem hiding this comment.
title="SHA2 256-bit hash example" in spanish
|
Is there a way to translate the titles of code chunks as well? ( /es/guides/make-onetime-payment/ ) |
Anca2022
reviewed
Sep 8, 2025
Anca2022
reviewed
Sep 8, 2025
|
|
||
| ## 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. |
There was a problem hiding this comment.
Suggested change
| 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. |
Anca2022
reviewed
Sep 8, 2025
|
|
||
| ## 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. |
There was a problem hiding this comment.
Suggested change
| 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. |
Anca2022
reviewed
Sep 8, 2025
| } | ||
| ``` | ||
|
|
||
|  |
There was a problem hiding this comment.
the alt text for the image "[Create the http signature]" should be in spanish
Co-authored-by: Sarah Jones <[email protected]>
Co-authored-by: Anca Matei <[email protected]>
Co-authored-by: Anca Matei <[email protected]>
Co-authored-by: Anca Matei <[email protected]>
Co-authored-by: Anca Matei <[email protected]>
Co-authored-by: Anca Matei <[email protected]>
Co-authored-by: Anca Matei <[email protected]>
Co-authored-by: Sarah Jones <[email protected]>
JoblersTune
approved these changes
Sep 8, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description of changes
Required
Conditional