---
updatedAt: 2026-07-15T00:54:13.000Z
agentTools:
projectIndex: https://docs.orkestapay.com/llms.txt
---
# PayPal
## PayPal
PayPal es una plataforma que actúa como intermediario en transacciones de pago en línea, permitiendo a los usuarios realizar y recibir pagos de manera segura y rápida.
En esencia, PayPal simplifica el proceso de pago digital proporcionando una experiencia segura, global y conveniente para compradores y vendedores.
## Operaciones soportadas
| Operación | Descripción |
| --------------------------------- | ------------------------------------------------ |
| ✅ **Autorización de pago** | Bloquea fondos en la tarjeta del cliente. |
| ✅ **Captura de pago** | Completa la transacción y transfiere los fondos. |
| ✅ **Pago directo** | Combina autorización y captura en un solo paso. |
| ✅ **Reembolso** | Devuelve el monto completo de una transacción. |
| ✅ **Reembolso parcial** | Devuelve parte del monto capturado. |
| ✅ **Cancelación de autorización** | Revierte una autorización que no fue capturada. |
## Integración
### 1. Configurar PayPal como método de pago
Para realizar la integración de **PayPal**, primero deberás de realizar una serie de configuraciones desde el portal de OrkestaPay. Visita nuestra guía de configuración de [Proveedores](/developer-center/docs/proveedores#google-pay) y busca el método de pago **PayPal**.
### 2. Implementar botón de pago
Para realizar la tokenización de los datos de pago hay que seguir los siguientes pasos:
1. **Incluir scripts de OrkestaPay**: Utilizar los scripts de OrkestaPay en tu aplicación web.
2. **Inicializar parámetros**: Aquí se definen las credenciales de OrkestaPay, así como datos referentes al pago a procesar.
3. **Renderizar el botón de pago**: Colocar el botón de PayPal en tu frontend.
#### Recursos necesarios:
**CSS**
```html
```
**JS**
```html
```
#### Ejemplo de código
En el siguiente snippet de código hay ciertos parámetros que son necesarios de reemplazar con los datos de tu comercio:
* `public_key` : Llave pública, estas credenciales las puedes obtener en el portal de OrkestaPay.
* `merchant_id:` ID del comercio, estas credenciales las puedes obtener en el portal de OrkestaPay.
* `is_sandbox:` Define si las credenciales que estás por operar son de pruebas o productivas.
En este ejemplo se capturan credenciales sensibles en un formulario, **estas credenciales deberán de ser manejadas desde el backend.**
* `client_id` : Esta llave en conjunto con la llave secreta, permitirá la autenticación para poder comunicarse con el API de OrkestaPay. **Es utilizada en el servidor.**
* `client_secret:` Esta llave en conjunto con la llave de acceso, permitirá la autenticación para poder comunicarse con el API de OrkestaPay. **Es utilizada en el servidor.**
### INFORMACIÓN
Para consultar las credenciales de OrkestaPay, puedes visitar nuestra guía [Obtener llaves de API](https://orkestapay.readme.io/docs/obtener-llaves-del-api).
```html
PayPal web component
OrkestaPay payment method PayPal web component
```
### NOTA
Este código es solo con fines demostrativos, que integra código de frontend y código que debería de ejecutarse desde un backend, por lo tanto es tú responsabilidad realizar una implementación con buenas prácticas.
### Explicación del código
#### Variables y Funciones Iniciales
* `orkestaPay`: Objeto principal para interactuar con la API de OrkestaPay.
* `paymentId`: Almacena el ID del pago actual.
* `initValues()`: Configuración inicial, como claves y detalles de transacción (monto, moneda, etc.).
#### Función `main`
* Función autoejecutable que:
1. Inicializa **OrkestaPay** con valores iniciales.
2. Crea un botón de PayPal como un **Web Component** (``).
3. Configura parámetros del botón:
* `payment_details`: Define las funciones para crear y confirmar pagos.
* `theme`: Personalización visual (color, forma, altura).
4. Agrega el botón al contenedor (`button-container`).
#### Operaciones de backend
##### Autenticación (`authenticate`)
* Genera un token de acceso:
* Envía las credenciales del cliente (`client_id` y `client_secret`) a la API.
* Devuelve un token que se usa para autorizar las solicitudes.
##### Registro de Pedidos (`createOrder`)
* Crea un nuevo pedido:
* Incluye información básica como el monto total, moneda, y productos (ficticios en este caso).
##### Creación de Pago (`createPayment`)
* Recibe un método de pago (`paymentMethod`).
* Pasos:
1. Registra un pedido (`createOrder`).
2. Obtiene información del dispositivo.
3. Envía una solicitud `POST` a la API para crear un pago.
4. Maneja la respuesta y actualiza los detalles del pago (`handlePaymentCreated`).
##### Confirmación de Pagos (`confirmPayment`)
* Confirma el pago previamente creado mediante su `paymentId`.
#### **Manejo de respuestas y errores**
* `handleFetchResponse(response)`: Devuelve el cuerpo de la respuesta si es exitosa; en caso contrario, rechaza la promesa.
* `handleFetchError(error)`: Muestra errores en la consola.
### Pruebas
Para finalizar una prueba de integración deberás de contar con una cuenta de sandbox de PayPal de tipo personal.
### NOTA
Para más información sobre pruebas con PayPal dirígete a su documentación oficial: [https://developer.paypal.com/tools/sandbox/](https://developer.paypal.com/tools/sandbox/)