PayPal

Introducción

PayPal es un sistema de pagos en línea que ofrece transferencias de dinero entre usuarios, sean personas o comercios. Al integrar esta solución de pago en tu comercio con Addon Payments, podrás acceder al sistema de pagos en línea de PayPal y conectar con sus millones de clientes.

Para que tu comercio pueda usar PayPal en tu integración de Addon Payments, debe tener una cuenta empresa de PayPal, además de obtener otra serie de datos de tu cuenta PayPal. Tienes todos los requisitos previos que debe cumplir tu comercio en esta sección.

Para que tus clientes puedan pagar con PayPal deben tener una cuenta personal o de empresa activa y válida.

Tipo de pago	Wallet
Países disponibles	Todos
Divisas disponibles	Todas
Cantidad mínima para pagos	Sin límite mínimo
Cantidad máxima para pagos	Sin límite máximo
¿Necesita redirección?	Sí
¿Admite pago en dos pasos?	Sí, pre-autorizaciones y pre-autenticaciones
¿Admite devoluciones?	Sí, totales o parciales, desde el BackOffice o mediante petición H2H
Exenciones SCA	No
DCC	No

Operativas admitidas

Puedes integrar PayPal en Addon Payments en los 3 tipos de integración. Las operativas admitidas son:

Autorización: Un pago normal del cliente a tu comercio. La captura del importe es automática.
Pre-autorización: El cliente realiza el pago y el dinero se retiene en su cuenta. El comercio debe capturar el importe posteriormente.
Anulación: Libera el importe de una pre-autorización. Sólo se permiten anulaciones totales.
Captura (confirmación): Captura o confirmación total o parcial del importe de una transacción pre-autorizada. Se pueden hacer capturas múltiples (varias capturas sobre una transacción, hasta llegar al total).
Devoluciones: Devolución total o parcial del importe de una transacción. A través del BackOffice o mediante endpoint.
Payout: Pago del comercio al cliente. No confundir con devoluciones.
Pre-autenticación: El cliente autentica un importe sobre el que luego el comercio puede lanzar cobros o pre-autorizaciones. La diferencia con la pre-autorización, es que en este caso el importe que autentica el cliente NO se retiene en su cuenta.

Consideraciones iniciales para operativas de PayPal

Las operativas de la sección anterior están disponibles según la configuración del producto de tu comercio.

El producto es un identificador generado desde Addon Payments donde se configuran los métodos de pago. Un comercio (merchantId) puede tener varios productos con distintas configuraciones entre ellas.

En el caso de PayPal, el tipo de operativa se configura en el producto de Addon Payments:

Por defecto se configura el producto para operar con cobros (autorización y liquidación automática).
Para incluir nuevas operativas, como las de la sección anterior, indícalo a Soporte para su activación.
Si necesitas combinar operativas diferentes será necesario crear un producto por operativa. Indícalo a Soporte para su activación.
En la petición deberás enviar el productId correspondiente a la operativa. Por ejemplo, el productId será distinto si mandas una autorización con captura automática (por defecto) que si mandas una pre-autorización.

Otras consideraciones para la solución de pago PayPal:

Las retrocesiones de pagos (chargeback) son gestionadas directamente por PayPal.
Por defecto se configura el producto para la liquidación automática del cobro tras la autorización.
Una misma cuenta de PayPal puede ser usada por varios clientes.
No hay límite de cuentas de PayPal por cliente.

Si quieres modificar algunas de estas condiciones, solicítalo a Soporte.

Requisitos para usar PayPal

En esta sección tienes los requisitos que deben cumplir los clientes y comercios para poder usar PayPal en tu comercio con Addon Payments.

Requisitos para clientes

Estos son los requisitos para que tus clientes puedan utilizar PayPal como método de pago en tu comercio:

Disponer de una cuenta personal o de empresa de PayPal activa y con al menos una tarjeta asociada.
Si tus clientes tienen dudas, puedes remitir a tus clientes a la sección «Centro de ayuda» de la web de PayPal.

Requisitos para comercios

Estos son los requisitos previos para que tu comercio pueda integrar PayPal en Addon Payments. En caso de duda con el proceso de alta, acceso al panel de gestión de PayPal u otra consulta, ponte en contacto con el servicio técnico de PayPal.

Estos son los requisitos previos para integrar PayPal:

1. Crea una cuenta empresa para tu comercio en PayPal

Si ya la tienes, puedes saltar al paso siguiente. Si no, sigue estos pasos para crearla:

Accede a la página de inicio de PayPal y haz clic en «Crear cuenta», en la esquina superior derecha.
Selecciona el tipo de cuenta «Empresa» y pulsa el botón de «Comenzar».
Rellena el formulario y pulsa «Aceptar y crear cuenta».
Haz clic en «¡Comencemos!».
Selecciona el perfil de vendedor adecuado a tu comercio y haz clic en «Siguiente».
Rellena el formulario con los datos de tu comercio y pulsa en «Siguiente».

2. Obtener los datos de tu aplicación en PayPal

Accede al panel de gestión de tu comercio en PayPal con tu usuario y contraseña de la cuenta de empresa.
En la parte superior derecha haz clic en tu usuario y luego en «Configuración de la cuenta».
En la sección «Acceso a cuenta» busca «Acceso de API» y haz clic en «Actualizar».
Luego, pulsa en «Integración de las API NVP o SOAP (clásicas)» situado en la parte inferior derecha.
Se mostrará una ventana emergente donde deberás dejar marcada la opción «Firma de API» y pulsar en «Aceptar y enviar».
PayPal te mostrará una ventana emergente que contiene los siguientes datos: Nombre de usuario de API, Contraseña de API, Firma.
Guarda estos datos de forma segura para enviarlos más tarde al equipo de Soporte de Addon Payments.

3. Solicitar la configuración de la solución de pago

Como último paso previo antes de comenzar a integrar PayPal , debes solicitar al equipo de Soporte la activación y configuración de PayPal en tu TPV virtual. Debes facilitar estos datos obtenidos en el panel de gestión de PayPal:

Nombre de usuario de API
Contraseña de API
Firma

Datos para pruebas

Puedes hacer todas las transacciones que creas necesarias para verificar el correcto funcionamiento de PayPal en el entorno de pruebas de Addon Payments.

Para hacer transacciones de prueba de PayPal en Addon Payments, necesitas recuperar las cuentas de tipo personal y empresa que genera PayPal automáticamente en su entorno de pruebas cuando creas una cuenta tipo empresa. También puedes crear cuentas de PayPal para pruebas específicas en el panel de gestión de la plataforma. En este enlace tienes toda la información necesaria.

Para obtener las cuentas de pruebas ya creadas o crear nuevas, sigue estos pasos:

Accede a esta URL: https://developer.paypal.com
Inicia sesión con tu cuenta de empresa de PayPal.
En el portal de desarrolladores de PayPal, haz clic en «Sandbox accounts».
Se mostrará el listado de cuentas de prueba creadas en tu cuenta de PayPal.
Para modificar u obtener la contraseña de las cuentas, pulsa el botón de los 3 puntos en la columna del engranaje, luego pulsa «View/Edit account»
Verás la información de la cuenta. Copia la contraseña necesaria para poder realizar operaciones en el entorno de pruebas de PayPal.

Entornos y endpoints: Staging y Producción

Addon Payments cuenta con dos (2) entornos operativos independientes:

Entorno de Staging:

Es el primer entorno con el cual entrarás en contacto.
Puedes hacer pruebas con los datos de la sección anterior.
Esto te permite comprobar la correcta gestión de las diferentes casuísticas por parte de tu integración.
Las tarjetas y cuentas reales no funcionan.

Entorno de Producción:

Es el entorno en el cual las transacciones tienen efectos contables.
Únicamente se puede transaccionar con tarjetas y cuentas reales y operativas.

A continuación, tienes los endpoints según el tipo de integración:

Entorno	Hosted	Host2Host
Staging	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/tokenize	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/pay
Producción	https://checkout.addonpayments.com/EPGCheckout/rest/online/tokenize	https://checkout.addonpayments.com/EPGCheckout/rest/online/pay

Petición	Entorno	URL
Petición /auth	Staging	https://epgjs-mep-stg.addonpayments.com/auth
Petición /charge	Staging	https://epgjs-mep-stg.addonpayments.com/charge/v2
Petición /auth	Producción	https://epgjs-mep.addonpayments.com/auth
Petición /charge	Producción	https://epgjs-mep.addonpayments.com/charge/v2

Datos requeridos y opcionales PayPal

Recuerda que puedes integrar PayPal en cualquiera de las 3 integraciones de Addon Payments: Hosted, Host2Host y JavaScript.

Estos son los parámetros requeridos/obligatorios (R) y opcionales (O) que debes incluir en las peticiones de PayPal:

Campo	Formato	Tipo	Descripción	Ejemplo
merchantId	Numérico entero 4~7 dígitos	R	Es el indicador de tu comercio en la plataforma de AP. Es facilitado por Soporte en el correo de bienvenida, es común para los dos entornos	14983
productId	Numérico entero 6~11 dígitos	R	Identificador del producto creado en tu comercio en AP. Es facilitado en el correo de bienvenida. En PayPal, cada operativa tiene asociado un productId, por lo que deberás enviar uno distinto.	149830
paymentSolution	Alfanumérico Máx. 45 caracteres	R (sólo en H2H)	Nombre de la solución de pago por la cual debe procesarse la transacción. IMPORTANTE: Es requerido en H2H, envíalo en Hosted y JS si quieres que sólo salga la opción de pago con PayPal.	paypal
operationType	Alfanumérico Máx. 45 caracteres	R	Especifica el tipo de operación a realizar. Valores admitidos: – debit (por defecto): Transacción de pago. Es decir, el efectivo viaja desde la cuenta del cliente al comercio. – credit: Transacción de ingreso en cuenta del cliente. Es decir, el efectivo viaja desde el comercio hasta la cuenta del cliente. Por ejemplo, en el pago de un premio. No confundir con las devoluciones. Estas tienen su propio tipo de transacción.	debit
merchantTransactionId	Alfanumérico Máx. 12 caracteres	R	Es el identificador único de la transacción del comercio. Sirve para que tu plataforma enlace las notificaciones recibidas con el pedido del cliente.	pedido_91684
amount	Numérico decimal 0~1000000.00	R	Importe de la transacción. Si el importe tiene decimales, el separador es un punto (.). No se puede incluir el separador en los millares	127.5
currency	Alfabético 3 caracteres ISO-4217.3	R	Divisa de la transacción	EUR
country	Alfabético 2 caracteres ISO 3166-1 alfa-2	R	País desde el que se envía la transacción	ES
customerId	Alfanumérico Máx. 80 caracteres	R	Id. del cliente en tu plataforma de comercio electrónico.	A34623
firstName	Alfanumérico Máx. 30 caracteres	R	Nombre del cliente. Si tiene más de uno se separan con espacios.	Pablo
lastName	Alfanumérico Máx. 61 caracteres (30 caracteres por apellido + el espacio)	R	Apellidos del cliente. Se deben enviar los 2 apellidos separados por un espacio.	Ferrer Calas
statusURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma de comercio electrónico donde AP enviará la notificación con el estado de la transacción. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/status
successURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona al cliente si la transacción es autorizada. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/success
errorURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona al cliente si la transacción es denegada. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/error
cancelURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona el cliente si cancela la transacción durante el proceso de pago. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/cancel
awaitingURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona el cliente si la transacción está pendiente de procesar. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/awaiting

Integración Hosted

En esta sección tienes ejemplos de las distintas operativas disponibles para PayPal en la integración Hosted de Addon Payments. Te recomendamos que visites la documentación Hosted para conocer más detalles sobre esta integración.

Autorización

A continuación vamos a ver cómo realizar un pago con PayPal vía Hosted. La captura del importe es automática. Envía la petición al endpoint correspondiente.

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Estos son unos ejemplos de autorización mediante PayPal por Hosted. Recuerda que la petición en cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=4.00&currency=EUR&country=ES
&customerId=000001&firstName=Nombre&lastName=Apellido&productId=000001&operationType=debit
&statusURL=https://micomercio.com/recepcion_notificacion.php
&successURL=https://micomercio.com/Furl-ok.php&errorURL=https://micomercio.com/url-ko.php
&cancelURL=https://micomercio.com/url-cancelacion.php&awaitingURL=https://micomercio.com/url-espera.php

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/tokenize' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: mx3rdwlpuDA1vM14SFT5bw==' \
--form 'merchantId="12345"' \
--form 'encrypted="/kJtS1WhS33iGLIvOuv7ISPKF4D3lldTzKkEgeuuldajqZJ4jS9Nk1ZU/rpo/8e7wCT6tW5Yz1f6xQrAj7RCJXYgaiLpTFzNe9VDkGEYMCF5CI6z2eZmPQBFMsVJtroV3mvgBhRdK6j64utR' \
--form 'integrityCheck="e55c1dae947b376645b8fbd7f3612f0cf63045236c80b643f8335d3c4050ec70"'

Recibirás una respuesta a esta petición con el enlace al cajero Hosted al que debes redirigir al cliente.

Parámetros de la solicitud de autorización

Puedes ver los parámetros requeridos para enviar una petición de autorización PayPal vía Hosted en:

Tabla parámetros PayPal.

Importante: La autorización con captura automática es la operativa configurada por defecto, por lo que debes enviar el productId por defecto.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Estos son unos ejemplos de las notificaciones que recibirás durante una autorización en PayPal. La primera es una notificación de redirección que contiene la URL de PayPal donde el cliente debe completar la operación. La segunda es la notificación de estado de la operación.

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228640</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.00</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"EC-9KXXXXX03C","TIMESTAMP":"2024-09-11T14:48:19Z","CORRELATIONID":"5b9XXX88","ACK":"Success","VERSION":"124.0","BUILD":"58XXX96"}</details>
            <merchantTransactionId>09110002</merchantTransactionId>
            <operationType>DEBIT</operationType>
            <paymentSolution>paypal</paymentSolution>
            <redirectionResponse>redirect:https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&amp;token=EC-9XXXXXC&amp;useraction=commit</redirectionResponse>
            <status>REDIRECTED</status>
            <transactionId>228640</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>355a98a4_849d_447c_8f4e_2a891aaab8e2</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
    <workFlowResponse>
        <id>14327</id>
        <name>paypal redirect</name>
        <version>2</version>
    </workFlowResponse>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response operation-size="1">
        <message>WorkFlow has finished successfully, for transaction Id: 228656</message>
        <operations>
            <operation sorted-order="1">
            <amount>10.0</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"EC-1XXXX2M","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
            <merchantTransactionId>09110005</merchantTransactionId>
            <message>Transaction completed</message>
            <operationType>DEBIT</operationType>
            <paySolTransactionId>8U793640AG714562F</paySolTransactionId>
            <paymentDetails>
                <account>test@testy.com</account>
                <extraDetails/>
            </paymentDetails>
            <paymentSolution>paypal</paymentSolution>
            <status>SUCCESS</status>
            <transactionId>228656</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
            </operation>
        </operations>
        <optionalTransactionParams/>
        <status>SUCCESS</status>
    </response>

Operaciones autorizadas en 2 pasos: pre-autorización y pre-autenticación

Para activar cualquiera de estas operativas debes contactar con Soporte. Cada operativa tiene un productId asignado, que deberás tener en cuenta en las peticiones.

Estas son operativas distintas para pagar en 2 fases. Para añadir cualquiera de estas operativas contacta con Soporte. Soporte configura la operativa, que va asociada a un producto (productId) distinto que deberás mandar en la petición.

Estos son los puntos comunes que tienen las pre-autorizaciones y pre-autenticaciones en PayPal:

Son válidas durante 29 días, es decir, podrás lanzar transacciones sobre la operación original durante este tiempo.
Las operaciones pre-autorizadas o pre-autenticadas tendrán el estado «PENDING» hasta que se realicen operaciones sobre las mismas.

A continuación, vamos a ver las particularidades de cada operativa:

Pre-autorización

La pre-autorización separa la autorización, que hace el cliente, de la captura del importe, que realiza el comercio.

Las pre-autorizaciones son válidas durante 29 días. Puedes capturar o anular la operación durante este tiempo.
Puedes lanzar capturas múltiples sobre una pre-autorización, pero sólo una (1) anulación del importe total.
Por ejemplo, en una pre-autorización de 100€ puedo:
- Hacer 2 capturas parciales de 30€ y 30€.
- Hacer una anulación de 40€. No puedo hacer 2 anulaciones parciales de 20€, ya que no se puede mandar el monto en las anulaciones, será siempre por el total restante.

Pre-autenticación

La pre-autenticación separa la autenticación, que hace el cliente, de la autorización y captura del importe, que realiza el comercio.

La diferencia con la pre-autorización es que en este caso el cliente autentica un importe que NO se retiene de su cuenta. Por tanto, no se garantiza la captura del importe.
Sobre una pre-autenticación se pueden lanzar autorizaciones (autorización + captura automática) y pre-autorizaciones (autorización y captura posterior).
Se admiten hasta 10 autorizaciones múltiples de importe parcial. Estas autorizaciones no pueden superar el 115% o 75$ de la autenticación original.

Petición

A continuación tienes un ejemplo de pre-autorización. Recuerda que la pre-autorización y la pre-autenticación tienen productId distintos asignados (en caso de que tengas las operativas activadas). Debes enviar el productId correspondiente en la petición.

Envía la petición al endpoint correspondiente.

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Estos son unos ejemplos de pre-autorización mediante PayPal por Hosted. Recuerda que la petición en cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=4.00&currency=EUR&country=ES
&customerId=000001&firstName=Nombre&lastName=Apellido&productId=000001&operationType=debit
&statusURL=https://micomercio.com/recepcion_notificacion.php?tipo?redireccion
&successURL=https://micomercio.com/url-ok.php&errorURL=https://micomercio.com/url-ko.php
&cancelURL=https://micomercio.com/url-cancelacion.php&awaitingURL=https://micomercio.com/url-espera.php

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/tokenize' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: mx3rdwlpuDA1vM14SFT5bw==' \
--form 'merchantId="12345"' \
--form 'encrypted="/kJtS1WhS33iGLIvOuv7ISPKF4D3lldTzKkEgeuuldajqZJ4jS9Nk1ZU/rpo/8e7wCT6tW5Yz1f6xQrAj7RCJXYgaiLpTFzNe9VDkGEYMCF5CI6z2eZmPQBFMsVJtroV3mvgBhRdK6j64utR' \
--form 'integrityCheck="e55c1dae947b376645b8fbd7f3612f0cf63045236c80b643f8335d3c4050ec70"'

Recibirás una respuesta a esta petición con el enlace al cajero Hosted al que debes redirigir al cliente.

Parámetros de la solicitud de pre-autorización y pre-autenticación

Los parámetros requeridos para enviar una petición de pre-autorización o pre-autenticación PayPal vía Hosted son:

Tabla parámetros PayPal.

Importante: Recuerda que debes enviar el «productId» en el que tengas activado la operativa de pre-autorización o pre-autenticación. Esto se debe a que en PayPal cada operativa lleva asociada un productId.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Recibirás una notificación con la URL de redirección de PayPal donde el cliente completará la operación.

Tras esto, recibirás una notificación de la pre-autorización o pre-autenticación en PayPal:

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228523</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.0</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"XX-XXXXXXXXXXXXXXXXX","SUCCESSPAGEREDIRECTREQUESTED":"false","TIMESTAMP":"2024-01-01T00:00:00Z","CORRELATIONID":"xxxxxxxxxxxxxxx","ACK":"Success","VERSION":"124.0","BUILD":"58613796","INSURANCEOPTIONSELECTED":"false","SHIPPINGOPTIONISDEFAULT":"false","PAYMENTINFO_0_TRANSACTIONID":"XXXXXXXXXXXXXXXXX","PAYMENTINFO_0_TRANSACTIONTYPE":"cart","PAYMENTINFO_0_PAYMENTTYPE":"instant","PAYMENTINFO_0_ORDERTIME":"2024-08-14T10:00:12Z","PAYMENTINFO_0_AMT":"10.00","PAYMENTINFO_0_TAXAMT":"0.00","PAYMENTINFO_0_CURRENCYCODE":"EUR","PAYMENTINFO_0_PAYMENTSTATUS":"Pending","PAYMENTINFO_0_PENDINGREASON":"authorization","PAYMENTINFO_0_REASONCODE":"None","PAYMENTINFO_0_PROTECTIONELIGIBILITY":"Eligible","PAYMENTINFO_0_PROTECTIONELIGIBILITYTYPE":"ItemNotReceivedEligible,UnauthorizedPaymentEligible","PAYMENTINFO_0_SECUREMERCHANTACCOUNTID":"XXXXXXXXXXXXX","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
            <merchantTransactionId>00000001</merchantTransactionId>
            <message>authorization</message>
            <operationType>PREAUTH</operationType>
            <paySolTransactionId>XXXXXXXXXXXXXXXXX</paySolTransactionId>
            <paymentDetails>
                <account>cliente@correoelectronico.com</account>
                <extraDetails/>
            </paymentDetails>
            <paymentMethod>Authorization</paymentMethod>
            <paymentSolution>paypal</paymentSolution>
            <status>PENDING</status>
            <transactionId>228523</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228675</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.0</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"XXXXXX","SUCCESSPAGEREDIRECTREQUESTED":"false","TIMESTAMP":"2024-09-12T14:17:48Z","CORRELATIONID":"XXXX","ACK":"Success","VERSION":"XX0","BUILD":"XXXXX","INSURANCEOPTIONSELECTED":"false","SHIPPINGOPTIONISDEFAULT":"false","PAYMENTINFO_0_TRANSACTIONID":"XXXXX","PAYMENTINFO_0_TRANSACTIONTYPE":"cart","PAYMENTINFO_0_PAYMENTTYPE":"None","PAYMENTINFO_0_ORDERTIME":"2024-09-12T14:17:48Z","PAYMENTINFO_0_AMT":"10.00","PAYMENTINFO_0_TAXAMT":"0.00","PAYMENTINFO_0_CURRENCYCODE":"EUR","PAYMENTINFO_0_PAYMENTSTATUS":"Pending","PAYMENTINFO_0_PENDINGREASON":"order","PAYMENTINFO_0_REASONCODE":"None","PAYMENTINFO_0_PROTECTIONELIGIBILITY":"None","PAYMENTINFO_0_SECUREMERCHANTACCOUNTID":"XXXXXXX","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
            <merchantTransactionId>09110005</merchantTransactionId>
            <message>Transaction pending</message>
            <operationType>DEBIT</operationType>
            <paySolTransactionId>O-5VL814130C249050H</paySolTransactionId>
            <paymentDetails>
            <account>CUSTOMER@custom.com</account>
            <extraDetails/>
            </paymentDetails>
            <paymentSolution>paypal</paymentSolution>
            <status>PENDING</status>
            <transactionId>228675</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
</response>

Si la pre-autorización o pre-autenticación es válida, quedará pendiente de capturar, anular o realizar otra acción. Su estado será «PENDING».

A partir de aquí, tienes varias opciones:

En las pre-autorizaciones puedes capturar o anular el importe. Visita la sección correspondiente.
En las pre-autenticaciones, puedes lanzar una autorización o pre-autorización, como has visto en esta misma sección.

Payout

Los Payouts son una operativa de pagos del comercio a la cuenta del cliente. No confundir con devoluciones. El objetivo de esta operativa es el pago de premios, por ejemplo. Debes solicitar a Soporte la activación de esta operativa, que irá asociada a un nuevo productId.

El tipo de Payout depende del flujo que tenga activo tu comercio. No se puede elegir el tipo de Payout (directo o en 2 pasos) con los parámetros de la petición. Existen 2 tipos de Payouts:

Payout directo: El cliente recibe el importe cuando la petición se completa con éxito.
Payout en 2 fases: El cliente inicia el proceso del Payout pero este queda pendiente de ser aprobado o rechazado por el comercio.

Para hacer un Payout, no es requerido que el cliente haya realizado un pago previo exitoso.

Para evitar rechazos debido a caracteres especiales en el nombre de los clientes te recomendamos verificar lo siguiente:

Accede al panel de gestión de tu comercio en PayPal.
En la parte superior derecha haz clic en tu usuario y luego en «Configuración de la cuenta».
Pulsa en «Pagos en sitio web», en el menú lateral izquierdo.
Localiza «Codificación de idioma de botones de PayPal» y pulsa «Actualizar».
En la ventana que se abre, pulsa en «Más opciones».
Verifica que la configuración de codificación es UTF-8 en ambos desplegables.
Pulsa en «Guardar».

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Envía la petición Hosted de Payout al endpoint establecido. A continuación, tienes un ejemplo en cadena y en cURL de la petición. Recuerda que la cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=4.00&currency=EUR&country=ES
&customerId=000001&firstName=Nombre&lastName=Apellido&productId=000001&operationType=credit
&statusURL=https://micomercio.com/recepcion_notificacion.php?tipo?redireccion
&successURL=https://micomercio.com/url-ok.php&errorURL=https://micomercio.com/url-ko.php
&cancelURL=https://micomercio.com/url-cancelacion.php&awaitingURL=https://micomercio.com/url-espera.php

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/tokenize' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: mx3rdwlpuDA1vM14SFT5bw==' \
--form 'merchantId="12345"' \
--form 'encrypted="/kJtS1WhS33iGLIvOuv7ISPKF4D3lldTzKkEgeuuldajqZJ4jS9Nk1ZU/rpo/8e7wCT6tW5Yz1f6xQrAj7RCJXYgaiLpTFzNe9VDkGEYMCF5CI6z2eZmPQBFMsVJtroV3mvgBhRdK6j64utR' \
--form 'integrityCheck="e55c1dae947b376645b8fbd7f3612f0cf63045236c80b643f8335d3c4050ec70"'

Parámetros de la solicitud de Payout

Los parámetros requeridos para un Payout en PayPal vía Hosted son los de esta tabla. Y debes modificar este dato:

operationType: credit

Importante: Recuerda que debes enviar el «productId» en el que tengas activado la operativa de Payout. Esto se debe a que en PayPal cada operativa lleva asociada un productId.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Al realizar un Payout de PayPal recibes 2 notificaciones. La primera indica AWAITING_PAYSOL o ERROR dependiendo de la petición. La segunda, indica el estado final del Payout.

				
					<?xml version="1.0" encoding="UTF-8"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228639</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.00</amount>
            <currency>EUR</currency>
            <details>{"TIMESTAMP":"2024-09-11T14:33:15Z","CORRELATIONID":"8XXXd3","ACK":"Success","VERSION":"124.0","BUILD":"5XXX71"}</details>
            <merchantTransactionId>09110001</merchantTransactionId>
            <message>Transaction was awaiting paysol</message>
            <operationType>CREDIT</operationType>
            <paymentSolution>paypal</paymentSolution>
            <status>AWAITING_PAYSOL</status>
            <transactionId>228639</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams />
    <status>SUCCESS</status>
    <workFlowResponse>
        <id>14327</id>
        <name>paypal redirect</name>
        <version>1</version>
    </workFlowResponse>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response operation-size="1">
        <message>WorkFlow has finished successfully, for transaction Id: 6546762</message>
        <operations>
            <operation sorted-order="1">
                <amount>10.00</amount>
                <currency>EUR</currency>
                <details>{"masspay_txn_id_1":"1EXXXXX0G","ipn_track_id":"49a0XXXXXXf1"}</details>
                <merchantTransactionId>TEST-JT-1</merchantTransactionId>
                <message>Transaction was success.</message>
                <operationType>CREDIT</operationType>
                <paySolTransactionId>1EU96261DV802030G</paySolTransactionId>
                <paymentDetails>
                    <account>testc@testy.com</account>
                    <extraDetails/>
                </paymentDetails>
                <paymentSolution>paypal</paymentSolution>
                <status>SUCCESS</status>
                <transactionId>6546762</transactionId>
                <respCode>
                    <code>0000</code>
                    <message>Successful</message>
                    <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
                </respCode>
            </operation>
        </operations>
        <optionalTransactionParams/>
        <status>SUCCESS</status>
        <workFlowResponse>
            <id>23022</id>
            <name>paypal credit</name>
            <version>2</version>
        </workFlowResponse>
    </response>

Integración Host2Host

En esta sección tienes ejemplos de las distintas operativas disponibles para PayPal en la integración Host2Host de Addon Payments. Te recomendamos que visites la documentación Host2Host para conocer más detalles sobre esta integración.

Autorización

A continuación vamos a ver cómo realizar un pago con PayPal vía Host2Host. La captura del importe es automática. Envía la petición al endpoint correspondiente.

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Estos son unos ejemplos de autorización mediante PayPal por Host2Host. Recuerda que la petición en cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=4.00&currency=EUR&country=ES
&customerId=000001&firstName=Nombre&lastName=Apellido&productId=000001&operationType=debit
&statusURL=https://micomercio.com/recepcion_notificacion.php?tipo?redireccion
&successURL=https://micomercio.com/url-ok.php&errorURL=https://micomercio.com/url-ko.php
&cancelURL=https://micomercio.com/url-cancelacion.php&awaitingURL=https://micomercio.com/url-espera.php

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/pay' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: mx3rdwlpuDA1vM14SFT5bw==' \
--form 'merchantId="12345"' \
--form 'encrypted="/kJtS1WhS33iGLIvOuv7ISPKF4D3lldTzKkEgeuuldajqZJ4jS9Nk1ZU/rpo/8e7wCT6tW5Yz1f6xQrAj7RCJXYgaiLpTFzNe9VDkGEYMCF5CI6z2eZmPQBFMsVJtroV3mvgBhRdK6j64utR' \
--form 'integrityCheck="e55c1dae947b376645b8fbd7f3612f0cf63045236c80b643f8335d3c4050ec70"'

Parámetros de la solicitud de autorización

Los parámetros requeridos para enviar una petición de autorización PayPal vía Host2Host son:

Tabla parámetros PayPal.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228640</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.00</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"EC-9KXXXXX03C","TIMESTAMP":"2024-09-11T14:48:19Z","CORRELATIONID":"5b9XXX88","ACK":"Success","VERSION":"124.0","BUILD":"58XXX96"}</details>
            <merchantTransactionId>09110002</merchantTransactionId>
            <operationType>DEBIT</operationType>
            <paymentSolution>paypal</paymentSolution>
            <redirectionResponse>redirect:https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&amp;token=EC-9XXXXXC&amp;useraction=commit</redirectionResponse>
            <status>REDIRECTED</status>
            <transactionId>228640</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>355a98a4_849d_447c_8f4e_2a891aaab8e2</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
    <workFlowResponse>
        <id>14327</id>
        <name>paypal redirect</name>
        <version>2</version>
    </workFlowResponse>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228656</message>
    <operations>
        <operation sorted-order="1">
        <amount>10.0</amount>
        <currency>EUR</currency>
        <details>{"TOKEN":"EC-1XXXX2M","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
        <merchantTransactionId>09110005</merchantTransactionId>
        <message>Transaction completed</message>
        <operationType>DEBIT</operationType>
        <paySolTransactionId>8U793640AG714562F</paySolTransactionId>
        <paymentDetails>
            <account>test@testy.com</account>
            <extraDetails/>
        </paymentDetails>
        <paymentSolution>paypal</paymentSolution>
        <status>SUCCESS</status>
        <transactionId>228656</transactionId>
        <respCode>
            <code>0000</code>
            <message>Successful</message>
            <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
        </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
</response>

Operaciones autorizadas en 2 pasos: pre-autorización y pre-autenticación

Consulta la explicación de estas operativas en esta sección.

A continuación tienes un ejemplo de petición de pre-autorización de PayPal vía Host2Host. Debes indicar a Soporte la activación de estas operativas, que irán asociadas a un nuevo productId.

Petición

Envía la petición al endpoint correspondiente.

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Estos son unos ejemplos de pre-autorización mediante PayPal vía Host2Host. Recuerda que la petición en cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=4.00&currency=EUR&country=ES
&customerId=000001&firstName=Nombre&lastName=Apellido&productId=000001&operationType=debit
&statusURL=https://micomercio.com/recepcion_notificacion.php
&successURL=https://micomercio.com/url-ok.php&errorURL=https://micomercio.com/url-ko.php
&cancelURL=https://micomercio.com/url-cancelacion.php&awaitingURL=https://micomercio.com/url-espera.php

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/pay' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: mx3rdwlpuDA1vM14SFT5bw==' \
--form 'merchantId="12345"' \
--form 'encrypted="/kJtS1WhS33iGLIvOuv7ISPKF4D3lldTzKkEgeuuldajqZJ4jS9Nk1ZU/rpo/8e7wCT6tW5Yz1f6xQrAj7RCJXYgaiLpTFzNe9VDkGEYMCF5CI6z2eZmPQBFMsVJtroV3mvgBhRdK6j64utR' \
--form 'integrityCheck="e55c1dae947b376645b8fbd7f3612f0cf63045236c80b643f8335d3c4050ec70"'

Parámetros de la solicitud de pre-autorización y pre-autenticación

Los parámetros requeridos para enviar una petición de pre-autorización o pre-autenticación PayPal vía Host2Host son:

Tabla parámetros PayPal.

Importante: Recuerda que debes enviar el «productId» en el que tengas activado la operativa de pre-autorización o pre-autenticación. Esto se debe a que en PayPal cada operativa lleva asociada un productId.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Recibirás una notificación con la URL de redirección de PayPal donde el cliente completará la operación.

Tras esto, recibirás una notificación de la pre-autorización o pre-autenticación en PayPal:

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228523</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.0</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"XX-XXXXXXXXXXXXXXXXX","SUCCESSPAGEREDIRECTREQUESTED":"false","TIMESTAMP":"2024-01-01T00:00:00Z","CORRELATIONID":"xxxxxxxxxxxxxxx","ACK":"Success","VERSION":"124.0","BUILD":"58613796","INSURANCEOPTIONSELECTED":"false","SHIPPINGOPTIONISDEFAULT":"false","PAYMENTINFO_0_TRANSACTIONID":"XXXXXXXXXXXXXXXXX","PAYMENTINFO_0_TRANSACTIONTYPE":"cart","PAYMENTINFO_0_PAYMENTTYPE":"instant","PAYMENTINFO_0_ORDERTIME":"2024-08-14T10:00:12Z","PAYMENTINFO_0_AMT":"10.00","PAYMENTINFO_0_TAXAMT":"0.00","PAYMENTINFO_0_CURRENCYCODE":"EUR","PAYMENTINFO_0_PAYMENTSTATUS":"Pending","PAYMENTINFO_0_PENDINGREASON":"authorization","PAYMENTINFO_0_REASONCODE":"None","PAYMENTINFO_0_PROTECTIONELIGIBILITY":"Eligible","PAYMENTINFO_0_PROTECTIONELIGIBILITYTYPE":"ItemNotReceivedEligible,UnauthorizedPaymentEligible","PAYMENTINFO_0_SECUREMERCHANTACCOUNTID":"XXXXXXXXXXXXX","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
            <merchantTransactionId>00000001</merchantTransactionId>
            <message>authorization</message>
            <operationType>PREAUTH</operationType>
            <paySolTransactionId>XXXXXXXXXXXXXXXXX</paySolTransactionId>
            <paymentDetails>
                <account>cliente@correoelectronico.com</account>
                <extraDetails/>
            </paymentDetails>
            <paymentMethod>Authorization</paymentMethod>
            <paymentSolution>paypal</paymentSolution>
            <status>PENDING</status>
            <transactionId>228523</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228675</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.0</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"XXXXXX","SUCCESSPAGEREDIRECTREQUESTED":"false","TIMESTAMP":"2024-09-12T14:17:48Z","CORRELATIONID":"XXXX","ACK":"Success","VERSION":"XX0","BUILD":"XXXXX","INSURANCEOPTIONSELECTED":"false","SHIPPINGOPTIONISDEFAULT":"false","PAYMENTINFO_0_TRANSACTIONID":"XXXXX","PAYMENTINFO_0_TRANSACTIONTYPE":"cart","PAYMENTINFO_0_PAYMENTTYPE":"None","PAYMENTINFO_0_ORDERTIME":"2024-09-12T14:17:48Z","PAYMENTINFO_0_AMT":"10.00","PAYMENTINFO_0_TAXAMT":"0.00","PAYMENTINFO_0_CURRENCYCODE":"EUR","PAYMENTINFO_0_PAYMENTSTATUS":"Pending","PAYMENTINFO_0_PENDINGREASON":"order","PAYMENTINFO_0_REASONCODE":"None","PAYMENTINFO_0_PROTECTIONELIGIBILITY":"None","PAYMENTINFO_0_SECUREMERCHANTACCOUNTID":"XXXXXXX","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
            <merchantTransactionId>09110005</merchantTransactionId>
            <message>Transaction pending</message>
            <operationType>DEBIT</operationType>
            <paySolTransactionId>O-5VL814130C249050H</paySolTransactionId>
            <paymentDetails>
            <account>CUSTOMER@custom.com</account>
            <extraDetails/>
            </paymentDetails>
            <paymentSolution>paypal</paymentSolution>
            <status>PENDING</status>
            <transactionId>228675</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
</response>

Si la pre-autorización o pre-autenticación es válida, quedará pendiente de capturar, anular o realizar otra acción. Su estado será «PENDING».

A partir de aquí, tienes varias opciones:

En las pre-autorizaciones puedes capturar o anular el importe. Visita la sección correspondiente.
En las pre-autenticaciones, puedes lanzar una autorización o pre-autorización, como has visto en esta misma sección.

Payout

Los Payouts son una operativa de pagos del comercio a la cuenta del cliente. Más detalles sobre esta operativa en esta sección.

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Envía la petición H2H de Payout al endpoint establecido. A continuación, tienes un ejemplo en cadena y en cURL de la petición. Recuerda que la cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=4.00&currency=EUR&country=ES
&customerId=000001&firstName=Nombre&lastName=Apellido&productId=000001&operationType=credit
&statusURL=https://micomercio.com/recepcion_notificacion.php
&successURL=https://micomercio.com/url-ok.php&errorURL=https://micomercio.com/url-ko.php
&cancelURL=https://micomercio.com/url-cancelacion.php&awaitingURL=https://micomercio.com/url-espera.php

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/pay' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: mx3rdwlpuDA1vM14SFT5bw==' \
--form 'merchantId="12345"' \
--form 'encrypted="/kJtS1WhS33iGLIvOuv7ISPKF4D3lldTzKkEgeuuldajqZJ4jS9Nk1ZU/rpo/8e7wCT6tW5Yz1f6xQrAj7RCJXYgaiLpTFzNe9VDkGEYMCF5CI6z2eZmPQBFMsVJtroV3mvgBhRdK6j64utR' \
--form 'integrityCheck="e55c1dae947b376645b8fbd7f3612f0cf63045236c80b643f8335d3c4050ec70"'

Parámetros de la solicitud de Payout

Los parámetros requeridos para un Payout en PayPal vía Host2Host son los de esta tabla. Y debes modificar este dato:

operationType: credit

Importante: Recuerda que debes enviar el «productId» en el que tengas activado la operativa de Payout. Esto se debe a que en PayPal cada operativa lleva asociada un productId.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Al realizar un Payout de PayPal recibes 2 notificaciones. La primera indica AWAITING_PAYSOL o ERROR dependiendo de la petición. La segunda, indica el estado final del Payout.

				
					<?xml version="1.0" encoding="UTF-8"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228639</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.00</amount>
            <currency>EUR</currency>
            <details>{"TIMESTAMP":"2024-09-11T14:33:15Z","CORRELATIONID":"8XXXd3","ACK":"Success","VERSION":"124.0","BUILD":"5XXX71"}</details>
            <merchantTransactionId>09110001</merchantTransactionId>
            <message>Transaction was awaiting paysol</message>
            <operationType>CREDIT</operationType>
            <paymentSolution>paypal</paymentSolution>
            <status>AWAITING_PAYSOL</status>
            <transactionId>228639</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams />
    <status>SUCCESS</status>
    <workFlowResponse>
        <id>14327</id>
        <name>paypal redirect</name>
        <version>1</version>
    </workFlowResponse>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response operation-size="1">
        <message>WorkFlow has finished successfully, for transaction Id: 6546762</message>
        <operations>
            <operation sorted-order="1">
                <amount>10.00</amount>
                <currency>EUR</currency>
                <details>{"masspay_txn_id_1":"1EXXXXX0G","ipn_track_id":"49a0XXXXXXf1"}</details>
                <merchantTransactionId>TEST-JT-1</merchantTransactionId>
                <message>Transaction was success.</message>
                <operationType>CREDIT</operationType>
                <paySolTransactionId>1EU96261DV802030G</paySolTransactionId>
                <paymentDetails>
                    <account>testc@testy.com</account>
                    <extraDetails/>
                </paymentDetails>
                <paymentSolution>paypal</paymentSolution>
                <status>SUCCESS</status>
                <transactionId>6546762</transactionId>
                <respCode>
                    <code>0000</code>
                    <message>Successful</message>
                    <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
                </respCode>
            </operation>
        </operations>
        <optionalTransactionParams/>
        <status>SUCCESS</status>
        <workFlowResponse>
            <id>23022</id>
            <name>paypal credit</name>
            <version>2</version>
        </workFlowResponse>
    </response>

Transacciones secundarias: Captura, anulación y devolución

Las transacciones secundarias en PayPal son aquellas que se realizan sobre una transacción original para modificar su estado y generar un movimiento de fondos. Las transacciones secundarias sólo se pueden realizar sobre operaciones con un status determinado, como veremos a continuación.

Puedes realizar operaciones secundarias de 2 formas:

1. A través del portal BackOffice de AP:

En la guía de Consulta de operaciones tienes más información sobre cómo gestionar transacciones secundarias en el portal BackOffice de Addon Payments.
Al finalizar una operación secundaria a través del panel BackOffice, AP enviará una notificación a tu plataforma con el tipo de operación y su importe a la URL de notificación indicada en «statusURL», en la petición de la transacción original. Puedes habilitar que tu plataforma de comercio electrónico gestione estas notificaciones y actualice el estado de las operaciones.

2. Mediante el envío de una petición a un endpoint de AP por integración Host2Host:

A continuación veremos cómo enviar la petición correspondiente: captura, anulación o devolución con la integración de PayPal.
Estos son los endpoints correspondientes según el tipo de operación secundaria y el entorno donde operes:

Petición	Entorno	URL
Captura	Staging	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/capture
Anulación	Staging	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/void
Devolución	Staging	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/rebate
Captura	Producción	https://checkout.addonpayments.com/EPGCheckout/rest/online/capture
Anulación	Producción	https://checkout.addonpayments.com/EPGCheckout/rest/online/void
Devolución	Producción	https://checkout.addonpayments.com/EPGCheckout/rest/online/rebate

Captura y anulación

La captura es una operación secundaria que permite liquidar el importe a favor del comercio un importe pre-autorizado (en estado «PENDING»). La anulación es una operación secundaria que permite liberar el importe a favor del cliente de una operación pre-autorizada (en estado «PENDING»). Ten estos puntos en cuenta para las capturas y anulaciones en PayPal:

Puedes capturar o anular el importe de una operación durante 29 días después de la pre-autorización inicial.
Puedes hacer capturas totales o parciales.
Puedes hacer capturas múltiples sobre una misma operación.
Únicamente puedes hacer anulaciones totales (o parciales del importe total restante).
Por ejemplo, sobre una operación de 100€, puedes hacer 4 capturas por valor de 20€ y una anulación por valor de 20€. NO puedes hacer anulaciones múltiples, sólo total o por el importe restante.

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Este es un ejemplo de captura total en PayPal en cadena y cURL. Recuerda que la cadena debe pasar el proceso de cifrado.

Nota: La petición de anulación es igual aunque cambiando el endpoint. Recuerda que en las anulaciones, no se envía el amount.

				
					merchantId=12345&merchantTransactionId=27258897&paymentSolution=paypal&transactionId=7556056

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/capture' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: Z7VA6TpG9B84X9x9qqXoWQ==' \
--form 'merchantId="12345"' \
--form 'encrypted="4xUYxJxLc/ABCyqJfwttTalkds3YeijsJe6MlTnC6mgmbm0aXKwhI7thwa70o6lLyjrUtW8fFNUWf/l3jIojR4H5nW54Pl+GxerG1/AjMFpHlacchB3+kfkZzko42dQKk7MopAALi6SAFbl1Uq//qsESz8fV07ED7IvRQwlXREZDFtxQn2m9eyPr5zrJczILhRx27p3lqFQ61Sqlq0nCN+3sgJmuPUMKRqlXhYqf+vErv+fBaZMPV/8iKgERJLpIjPn+HZSLpc+q5VBcD4b+rGAgEKNi56Ni/MPCpKVWBUv8HFb06PngrLfiXcnFTfNeegg0XPkkmuGwR1l1y/k1tv9dPrdBkSIwE2OuHYvrkrn+NAOTHBxjGR4Ap93aZEwcPX9afkHkFOMi/5e3JdoxtFvSwOCe1ScEw2vRDhonE+5lV7jwOrqSMr+tfWVGPqzrYj/DZiQwCIUQJM6g5x+ocLTAURzz4IiJ26kBlQpYVnedKEVhevNJNZ88z6m50W2THtDR70pQq6qjF37NCfOeq/UDCg0RB/MPfYUJRUIsfPk=' \
--form 'integrityCheck="1c256f5b834e5db6d5f453043a8a3830859b308f297cc2cf423064510c5c9b72"'

Parámetros de la solicitud de captura y anulación

Estos son los parámetros a enviar en una petición de captura o anulación. La columna tipo indica si el elemento es Requerido/Obligatorio (R) u Opcional (O):

Campo	Formato	Tipo	Descripción	Ejemplo
merchantId	Numérico entero 4~7 dígitos	R	Es el indicador de tu comercio en la plataforma de AP. Es facilitado por Soporte en el correo de bienvenida, es común para los dos entornos	14983
transactionId	Numérico entero Máx. 100 dígitos	R	Identificador de la transacción original sobre la cual va a realizarse una operación secundaria, como captura, liberación o devolución.	76543210
paymentSolution	Alfanumérico Máx. 45 caracteres	R	Nombre de la solución de pago por la cual ha sido procesada la transacción inicial. Se indica en la respuesta de la transacción original.	paypal
merchantTransactionId	Alfanumérico Máx. 12 caracteres	R	Identificador de la transacción en tu plataforma de comercio electrónico. Sirve para que tu plataforma enlace las notificaciones recibidas con el pedido del cliente. No puede repetirse entre transacciones.	pedido_91684
amount	Numérico decimal 0~1000000.00	O	Importe de la captura. Si no se envía, la captura será total. En PayPal no se puede mandar el monto de la anulación, esta siempre se hará por el importe restante.	10.50
description	Máx. 1000 caracteres Página de códigos Latin-1 (ISO-8859-1)	O	Descripción de la transacción. Se guarda en los detalles de la transacción y se devuelve en la notificación. No afecta a la transacción, sirve para que puedas realizar una mejor identificación.	Captura después de entregar producto

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Estos son unos ejemplos de notificación a una captura parcial, a una total y a una anulación. La notificación de captura parcial y total es igual en formato.

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <operations>
        <operation sorted-order="1">
            <amount>5.00</amount>
            <currency>EUR</currency>
            <merchantTransactionId>00000001</merchantTransactionId>
            <message>Completed None</message>
            <operationType>CAPTURE</operationType>
            <optionalTransactionParams/>
            <originalTransactionId>228523</originalTransactionId>
            <paySolTransactionId>XXXXXXXXXXXXXXXXX</paySolTransactionId>
            <paymentSolution>paypal</paymentSolution>
            <status>SUCCESS</status>
            <transactionId>228528</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>f9b95427_ccee_4fe8_a19f_70bc34d56065</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <operations>
        <operation sorted-order="1">
            <amount>10.00</amount>
            <currency>EUR</currency>
            <merchantTransactionId>00000001</merchantTransactionId>
            <message>Completed None</message>
            <operationType>CAPTURE</operationType>
            <optionalTransactionParams/>
            <originalTransactionId>228523</originalTransactionId>
            <paySolTransactionId>XXXXXXXXXXXXXXXXX</paySolTransactionId>
            <paymentSolution>paypal</paymentSolution>
            <status>SUCCESS</status>
            <transactionId>228528</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>f9b95427_ccee_4fe8_a19f_70bc34d56065</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <operations>
        <operation sorted-order="1">
            <amount>15.0</amount>
            <currency>EUR</currency>
            <merchantTransactionId>241120013</merchantTransactionId>
            <message>5Y0998719K380973L</message>
            <operationType>VOID</operationType>
            <optionalTransactionParams/>
            <originalTransactionId>289757</originalTransactionId>
            <paymentSolution>paypal</paymentSolution>
            <status>SUCCESS</status>
            <transactionId>289758</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>c44f3881_fd4a_454a_911a_4244b0098bef</uuid>
            </respCode>
        </operation>
    </operations>
</response>

Devoluciones

Puedes hacer devoluciones totales o parciales de transacciones PayPal. Ten en cuenta estas condiciones para las devoluciones de PayPal:

La fecha límite de devolución es de 180 días (6 meses) desde la autorización.
La transacción sobre la que quieras hacer la devolución debe estar autorizada y capturada (status SUCCESS). No puedes hacer devoluciones sobre transacciones con status PENDING o ERROR.
En el caso de pago en 2 pasos, debes lanzar la devolución sobre la operación de captura o autorización, NO sobre la original. Esto implica que si hemos hecho 2 capturas parciales para una operación, debemos enviar 2 peticiones de devolución, cada una referenciando al transactionId de captura correspondiente.
Para hacer una devolución parcial debes enviar el campo «amount» en la petición. El importe total de las devoluciones parciales no puede superar el de la operación original

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Estos son unos ejemplos de petición de devolución de una transacción de PayPal por Host2Host. Recuerda que la petición en cadena debe pasar el proceso de cifrado.

				
					merchantId=12345&merchantTransactionId=00000001&amount=5.00&paymentSolution=paypal&transactionId=7742316

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/rebate' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: Z7VA6TpG9B84X9x9qqXoWQ==' \
--form 'merchantId="12345"' \
--form 'encrypted="4xUYxJxLc/ABCyqJfwttTalkds3YeijsJe6MlTnC6mgmbm0aXKwhI7thwa70J26kBlQpYVnedKEVhevNJNZ88z6m50W2THtDR70pQq6qjF37NCfOeq/UDCg0RB/MPfYUJRUIsfPk=' \
--form 'integrityCheck="1c256f5b834e5db6d5f453043a8a3830859b308f297cc2cf423064510c5c9b72"'

Parámetros de la solicitud de devolución

Estos son los parámetros a enviar para una petición de devolución de una transacción de PayPal. La columna tipo indica si el elemento es Requerido/Obligatorio (R) u Opcional (O):

Campo	Formato	Tipo	Descripción	Ejemplo
merchantId	Numérico entero 4~7 dígitos	R	Es el indicador de tu comercio en la plataforma de AP. Es facilitado por Soporte en el correo de bienvenida, es común para los dos entornos	14983
transactionId	Numérico entero Máx. 100 dígitos	R	Identificador de la transacción original sobre la cual va a realizarse una operación secundaria, como captura, liberación o devolución.	76543210
paymentSolution	Alfanumérico Máx. 45 caracteres	R	Nombre de la solución de pago por la cual ha sido procesada la transacción inicial. Se indica en la respuesta de la transacción original.	paypal
amount	Numérico decimal 0~1000000.00	R	Importe de la transacción. Si el importe contiene decimales, debe usar el punto (.) como separador No se puede incluir separador de millares.	10.50
merchantTransactionId	Alfanumérico Máx. 17 caracteres	R	Identificador de la transacción en tu plataforma de comercio electrónico. Sirve para que tu plataforma enlace las notificaciones recibidas con el pedido del cliente. No puede repetirse entre transacciones.	pedido_91684
description	Máx. 1000 caracteres Página de códigos Latin-1 (ISO-8859-1)	O	Descripción de la transacción. Se guarda en los detalles de la transacción y se devuelve en la notificación. No afecta a la transacción, sirve para que puedas realizar una mejor identificación.	Devolución después de entregar producto

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Estos son unos ejemplos de la notificación recibida a una petición de devolución. En las notificaciones de devoluciones parciales, se indicará la cantidad restante por devolver (línea 17):

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <operations>
        <operation sorted-order="1">
            <amount>10</amount>
            <currency>EUR</currency>
            <details>{"FEEREFUNDAMT":"0.34","REFUNDTRANSACTIONID":"XXXXXXXXXXXXXXXXX","GROSSREFUNDAMT":"10.00","BUILD":"20240807202928903","ACK":"Success","PENDINGREASON":"None","CURRENCYCODE":"EUR","NETREFUNDAMT":"9.66","TIMESTAMP":"2024-01-01T00:00:00Z","REFUNDSTATUS":"Instant","CORRELATIONID":"xxxxxxxxxxxxx","VERSION":"124.0","TOTALREFUNDEDAMOUNT":"10.00"}</details>
            <merchantTransactionId>00000001</merchantTransactionId>
            <message>Instant</message>
            <operationType>REFUND</operationType>
            <optionalTransactionParams/>
            <originalAmount>10.0</originalAmount>
            <originalCurrency>EUR</originalCurrency>
            <originalTransactionId>7742316</originalTransactionId>
            <paySolTransactionId>XXXXXXXXXXXXXXXXX</paySolTransactionId>
            <paymentSolution>paypal</paymentSolution>
            <remainingAmount>0.0</remainingAmount>
            <status>SUCCESS</status>
            <transactionId>7742320</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>6f03480a_3ac0_4492_8b54_594f11259abe</uuid>
            </respCode>
        </operation>
    </operations>
    <status>SUCCESS</status>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <operations>
        <operation sorted-order="1">
            <amount>5</amount>
            <currency>EUR</currency>
            <details>{"FEEREFUNDAMT":"0.17","REFUNDTRANSACTIONID":"XXXXXXXXXXXXXXXXX","GROSSREFUNDAMT":"5.00","BUILD":"20240807202928903","ACK":"Success","PENDINGREASON":"None","CURRENCYCODE":"EUR","NETREFUNDAMT":"4.83","TIMESTAMP":"2024-01-01T00:00:00Z","REFUNDSTATUS":"Instant","CORRELATIONID":"xxxxxxxxxxxxx","VERSION":"124.0","TOTALREFUNDEDAMOUNT":"5.00"}</details>
            <merchantTransactionId>00000001</merchantTransactionId>
            <message>Instant</message>
            <operationType>REBATE</operationType>
            <optionalTransactionParams/>
            <originalAmount>10.0</originalAmount>
            <originalCurrency>EUR</originalCurrency>
            <originalTransactionId>7742316</originalTransactionId>
            <paySolTransactionId>7DW05686PE8434121</paySolTransactionId>
            <paymentSolution>paypal</paymentSolution>
            <remainingAmount>5.0</remainingAmount>
            <status>SUCCESS</status>
            <transactionId>228539</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>f3d5adee_600d_46c2_89c3_745a1d09e75b</uuid>
            </respCode>
        </operation>
    </operations>
    <status>SUCCESS</status>
</response>

Integración JavaScript

En esta sección tienes ejemplos de las distintas operativas disponibles para PayPal con la integración JavaScript. Te recomendamos que visites la documentación JavaScript para conocer más detalles sobre esta integración.

Autorización

A continuación vamos a ver cómo realizar un pago con PayPal vía Hosted, la captura del importe es automática. Envía la petición al endpoint correspondiente.

Obtención del authToken y renderizado del cajero

El primer paso es solicitar el authToken y renderizar el cajero. Este paso es igual independientemente de la integración JavaScript. Consulta la documentación:

Charge

Con la obtención del «prepayToken», podrás enviar la petición de pago/charge. A continuación, te mostramos un ejemplo de petición PayPal vía JavaScript. En el ejemplo cURL podrás ver el prepayToken que se envía en la cabecera de la petición.

				
					{
    "merchantId": "12345",
    "productId": "123456",
    "merchantTransactionId": "00000001",
    "amount": "10.00",
    "currency": "EUR",
    "country": "ES",
    "customerId": "S2324",
    "firstName": "Pablo",
    "lastName": "Ferrer Calas",
    "statusURL": "https://micomercio.com/recepcion_notificacion.php",
    "successURL": "https:// micomercio.com/url-ok.php",
    "errorURL": "https:// micomercio.com/url-ko.php",
    "cancelURL": "https:// micomercio.com/url-cancelacion.php",
    "awaitingURL": "https:// micomercio.com/url-espera.php",
    "operationType"= "debit",
    "paymentSolution"= "paypal"
}

				
					curl --location --request POST 'https://epgjs-mep-stg.addonpayments.com/charge/v2' \
--header 'Content-Type: application/json' \
--header 'prepayToken: 8862abf9-ca5a-49da-9527-1e3163e64954' \
--data-raw '{
    "merchantId": "12345",
    "productId": "123456",
    "merchantTransactionId": "00000001",
    "amount": "10.00",
    "currency": "EUR",
    "country": "ES",
    "customerId": "S2324",
    "firstName": "Pablo",
    "lastName": "Ferrer Calas",
    "statusURL": "https://micomercio.com/recepcion_notificacion.php?tipo=redireccion",
    "successURL": "https:// micomercio.com/url-ok.php",
    "errorURL": "https:// micomercio.com/url-ko.php",
    "cancelURL": "https:// micomercio.com/url-cancelacion.php",
    "awaitingURL": "https:// micomercio.com/url-espera.php",
    "operationType"= "debit",
    "paymentSolution"= "paypal"
}'

Parámetros de la solicitud charge

Puedes ver en la tabla común los parámetros requeridos para enviar una petición charge de autorización de PayPal vía JavaScript. Además, deberás enviar este parámetro obtenido después del renderizado del cajero:

prepayToken: Se envía en la cabecera de la petición. AP devuelve esta referencia después de que el cliente introduzca sus datos en el formulario de pago de JS. Es la referencia que enlaza con los datos de la tarjeta o cuenta del cliente para integración JavaScript.

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 228640</message>
    <operations>
        <operation sorted-order="1">
            <amount>10.00</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"EC-9KXXXXX03C","TIMESTAMP":"2024-09-11T14:48:19Z","CORRELATIONID":"5b9XXX88","ACK":"Success","VERSION":"124.0","BUILD":"58XXX96"}</details>
            <merchantTransactionId>09110002</merchantTransactionId>
            <operationType>DEBIT</operationType>
            <paymentSolution>paypal</paymentSolution>
            <redirectionResponse>redirect:https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&amp;token=EC-9XXXXXC&amp;useraction=commit</redirectionResponse>
            <status>REDIRECTED</status>
            <transactionId>228640</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>355a98a4_849d_447c_8f4e_2a891aaab8e2</uuid>
            </respCode>
        </operation>
    </operations>
    <optionalTransactionParams/>
    <status>SUCCESS</status>
    <workFlowResponse>
        <id>14327</id>
        <name>paypal redirect</name>
        <version>2</version>
    </workFlowResponse>
</response>

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response operation-size="1">
        <message>WorkFlow has finished successfully, for transaction Id: 228656</message>
        <operations>
            <operation sorted-order="1">
            <amount>10.0</amount>
            <currency>EUR</currency>
            <details>{"TOKEN":"EC-1XXXX2M","PAYMENTINFO_0_ERRORCODE":"0","PAYMENTINFO_0_ACK":"Success"}</details>
            <merchantTransactionId>09110005</merchantTransactionId>
            <message>Transaction completed</message>
            <operationType>DEBIT</operationType>
            <paySolTransactionId>8U793640AG714562F</paySolTransactionId>
            <paymentDetails>
                <account>test@testy.com</account>
                <extraDetails/>
            </paymentDetails>
            <paymentSolution>paypal</paymentSolution>
            <status>SUCCESS</status>
            <transactionId>228656</transactionId>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>b17b61b9_c4c4_4027_98a9_3e70421e6b87</uuid>
            </respCode>
            </operation>
        </operations>
        <optionalTransactionParams/>
        <status>SUCCESS</status>
    </response>

Operaciones autorizadas 2 pasos: pre-autorización y pre-autenticación

Consulta la explicación de estas operativas en esta sección. Recuerda que debes indicar a Soporte la activación de estas operativas, que se asociarán a un nuevo productId.

Charge, parámetros y respuesta

Los petición y parámetros a enviar para una pre-autorización o pre-autenticación es casi igual que en el charge de autorización de JavaScript. Debes modificar el siguiente parámetro:

productId: Envía el correspondiente a la operativa (pre-autorización o pre-autenticación) que vayas a realizar.

Recuerda que debes obtener el authToken y renderizar el cajero previamente.

Respuesta

La respuesta o notificación recibida la puedes ver aquí. El estado será «PENDING», por lo que quedará pendiente de realizar alguna acción:

En las pre-autorizaciones puedes capturar o anular el importe. Visita la sección correspondiente.
En las pre-autenticaciones puedes lanzar una autorización o pre-autorización, como has visto en esta misma sección.

Payout

Los Payouts son una operativa de pagos del comercio a la cuenta del cliente. Más detalles sobre esta operativa en esta sección.

Charge, parámetros y respuesta

Los petición y parámetros a enviar para un Payout es casi igual que en el charge de autorización de JavaScript. Debes modificar los siguientes parámetros:

operationType: credit
productId: Envía el correspondiente a la operativa (Payout) que vayas a realizar.

Recuerda que debes obtener el authToken y renderizar el cajero previamente.

Respuesta

La respuesta o notificación recibida la puedes ver aquí.

Códigos de error

Estos son los códigos de error que puedes recibir en las notificaciones de transacciones PayPal. Los puedes encontrar en las líneas «code», «paymentCode», «paymentMessage»

< code > Código Addon Payments	Mensaje Addon Payments	< paymentCode > Código solución pago	< paymentMessage > Mensaje solución pago
1501	Funtionality not available with this account	10303	Account is restricted.
1501	Funtionality not available with this account	10307	The user account is receive only and Therefore cannot send payments out.
1501	Funtionality not available with this account	10402	This merchant account is not permitted to set PaymentAction To Authorization. Please contact Customer Service.
1501	Funtionality not available with this account	10469	Express Auctions is unavailable.
1501	Funtionality not available with this account	11616	Merchant is not designated as airline merchant And can not pass airline itinerary data.
1502	Insufficient funds	10321	The account does not have sufficient funds to do this MassPay
1502	Insufficient funds	10608	The funding source is missing.
1502	Insufficient funds	11084	User does not have a good funding source with which to pay.
1502	Insufficient funds	13602	Refund failed due to insufficient funds in your PayPal account.
1505	The amount specified for this operation is incorrect please check the Payment Solution Respons	10413	The totals of the cart item amounts do not match order amounts.
1505	The amount specified for this operation is incorrect please check the Payment Solution Respons	11561	The initial amount is invalid.
1505	The amount specified for this operation is incorrect please check the Payment Solution Respons	11569	Cannot increase delinquent amount.
1506	The username and/or password used in the API call is incorrect.	10758	There’s been an error due to invalid API Username and/or password.
1507	Unknown error by the Payment Solution.	10001	Internal error
1507	Unknown error by the Payment Solution.	10320	Internal error.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10004	The transaction id is not valid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10010	Transaction refused because of an invalid argument. See additional error messages for details.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10011	Transaction refused because of an invalid transaction id value.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10313	The MassPay input file includes invalid data
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10401	Order total is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10406	The PayerID value is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10424	Shipping address is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10426	Item total is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10427	Shipping total is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10428	Handling total is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10429	Tax total is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10431	Item amount is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10432	Invoice ID value exceeds maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10433	Value of OrderDescription element has been truncated.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10434	Value of Custom element has been truncated.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10436	PageStyle value exceeds maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10437	cpp-header-image value exceeds maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10438	cpp-header-image value exceeds maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10439	cpp-header-back-color value exceeds maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10440	cpp-header-image value exceeds maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10441	The NotifyURL element value exceeds Maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10442	The ButtonSource element value exceeds Maximum allowable length.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10452	This transaction cannot be completed with Auction Items.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10471	ReturnURL is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10474	This transaction cannot be processed. The country code in the Shipping address must match the buyer’s country of residence.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10500	This transaction cannot be processed due To an invalid merchant configuration.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10501	This transaction cannot be processed due To an invalid merchant configuration.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10540	The transaction cannot be processed due to an invalid address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10561	There’s an error with this transaction. Please Enter complete billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10627	The invoice ID field is not supported for basic authorizations.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10630	Item amount is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10701	There’s an error with this transaction. Please enter a valid billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10702	There’s an error with this transaction. Please enter A valid address1 in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10703	There’s an error with this transaction. Please enter A valid address2 in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10704	There’s an error with this transaction. Please enter A valid city in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10705	There’s an error with this transaction. Please enter A valid state in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10706	There’s an error with this transaction. Please enter A valid postal code in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10707	There’s an error with this transaction. Please enter A valid country in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10708	There’s an error with this transaction. Please enter a complete billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10709	There’s an error with this transaction. Please enter an address1 in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10710	There’s an error with this transaction. Please enter a city in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10711	There’s an error with this transaction. Please enter your state in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10712	There’s an error with this transaction. Please enter your five digit postal code in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10713	There’s an error with this transaction. Please enter a country in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10714	There’s an error with this transaction. Please enter a valid billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10715	There’s an error with this transaction.Please enter a valid state in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10716	There’s an error with this transaction. Please enter your five digit postal code in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10717	There’s an error with this transaction. Please enter a valid postal code in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10718	There’s an error with this transaction. Please enter a valid city and state in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10719	There’s an error with this transaction. Please enter a valid shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10720	There’s an error with this transaction. Please enter a valid address1 in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10721	There’s an error with this transaction. Please enter a valid address2 in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10722	There’s an error with this transaction. Please enter a valid city in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10723	There’s an error with this transaction. Please enter a valid state in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10724	There’s an error with this transaction. Please Enter your five digit postal code in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10725	There was an error in the Shipping Address Country field.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10726	There’s an error with this transaction. Please enter a complete shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10732	There’s an error with this transaction. Please enter a valid shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10733	There’s an error with this transaction.Please enter a valid state in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10734	There’s an error with this transaction. Please enter Your five digit postal code in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10735	There’s an error with this transaction. Please enter Your five digit postal code in the shipping address
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10736	A match of the Shipping Address City, State, and Postal Code failed.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10744	This transaction cannot be processed. Please Enter a valid country code in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10745	This transaction cannot be processed. Please Enter a valid country code in the shipping address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	10746	This transaction cannot be processed. Please Enter a valid country code in the billing address.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11451	Billing Agreement Id or transaction Id is not valid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11458	Credit card details section must be empty; you cannot specify credit Card information in a non-direct payment (DCC) reference transaction.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11459	The shipping address must match the user’s address in the PayPal account.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11501	The merchant’s country is currently not supported.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11505	Subscription start date should be greater than current date.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11506	Max failed payments, if supplied, must be >= 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11507	Trial amount must be >= 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11508	Trial total billing cycles must be > 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11509	Trial billing period must be one of Day, Week, Month, SemiMonth, or Year.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11510	Trial amount must be >= 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11512	Trial shipping amount must be >= 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11514	The profile status is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11516	Billing Frequency must be > 0 and be less than or equal to one year.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11517	Total billing cycles must be >= 0 (0 means continuous).
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11518	Billing period must be one of Day, Week, Month, SemiMonth, or Year.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11519	Bill amount must be greater than 0
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11521	Shipping amount must be >= 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11523	Tax amount must be >= 0.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11531	The profile status must be one of (A)ctive, (C)ancelled, or e(X)pired.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11543	The payer’s country is currently not supported.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11544	The trial period status must be one of (A)ctive or (C)ancelled.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11550	Subscription start date should be valid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11552	The profile ID is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11553	Invalid action value provided.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11555	Note length is too long.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11556	Invalid profile status for suspend action; profile should be active.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11557	Invalid profile status for reactivate action; profile should be suspended.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11558	The activation type is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11560	The activation type is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11562	The auto bill type is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11581	Profile description is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11590	Based on your input request, profile already up to date.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11592	Subscription profiles are not supported for recurring payments.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11603	One or more critical fields in the request conflict with prior message With the same Message Submission ID (specified in MSGSUBID parameter).
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11604	Request for the specified Message Submission ID (specified in MSGSUBID Parameter) cannot be started until the previous request finishes.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11615	One of the data in airline itinerary is not valid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11801	You cannot pass both new and deprecated parameter address fields.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11802	You cannot pass both the new and deprecated Custom parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11803	You cannot pass both the new and deprecated Invoice ID parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11804	You cannot pass both the new and deprecated order description.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11805	You cannot pass both the new and deprecated order total or amount parameters.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11806	You cannot pass both the new and deprecated ProfileAddressChangeDate parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11807	You cannot pass both the new and deprecated ShippingMethod parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11810	Invalid Insurance Amount.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11811	Invalid Shipping Discount.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11812	The value of Description parameter has been truncated.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11813	Invalid callback URL.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11814	Invalid value for AllowNote.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11815	Item sales tax is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11820	Invalid Order URL.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11821	Invalid shipping options; you must specify a name And amount for each shipping option type.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11822	More than one shipping option type is marked as the default; You can only specify one default shipping option at a time.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11823	You must specify one shipping option type as the default.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11824	The callback timeout is zero; you must specify a longer timeout value.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11826	Invalid shipping total; it should equal the shipping Amount of the selected shipping option.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	11832	Maximum amount of order is less than itemized amounts; the value of all items, including handling, shipping, tax, and insurance cannot be greater Than the maximum amount of the order.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	12201	The item specified is either not valid or is not currently available For purchase as an Immediate Payment item.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	12205	Requests for eBay Immediate Payment items should not contain either eBay transaction ID or eBay order ID. If the fields are present, They should contain null values.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	12206	Order and Authorization are not acceptable values for PaymentAction when the item is an Immediate Payment.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	12208	eBay item amount does not match Express Checkout API item amount.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	13103	Payment Request ID must be unique for parallel payments.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	13104	Number of payment requests exceeds maximum number of supported requests.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	13105	Billing Agreement is not supported for parallel payments.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	13106	You cannot pass both the new and deprecated PaymentAction parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	13111	The Payment Action passed should be unique, mixed Payment Action not supported.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	13701	Item Category value is invalid. Only Digital or Physical are allowed.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	17004	Your request was refused because of an invalid `LocationType`. Set `LocationType` To `Store` for a BOPIS transaction or `PICKUP_DROP_OFF` for a PUDO transaction.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	17200	Funding Instrument is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	17203	Funding Instrument is invalid.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	17204	Expired funding instrument.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	19065	Invalid Request Parameter: RedeemedOfferAmount
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81001	A Parameter is Invalid : Unable to identify parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81200	Amt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81201	MaxAmt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81203	NotifyURL : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81205	ShipToStreet : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81206	ShipToStreet2 : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81207	ShipToCity : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81208	ShipToState : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81209	ShipToZip : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81210	Country : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81211	ReqConfirmShipping : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81212	Noshipping : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81213	AddrOverride : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81214	LocaleCode : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81215	PaymentAction : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81219	ItemAmt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81220	ShippingAmt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81221	HandlingTotalAmt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81222	TaxAmt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81223	IPAddress : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81224	ShipToName : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81225	L_Amt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81226	Amt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81227	L_TaxAmt : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81229	CompleteType : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81230	CurrencyCode : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81232	TransactionEntity : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81234	ExpDate : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81235	FirstName : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81236	LastName : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81237	Street : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81238	Street2 : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81239	City : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81243	RefundType : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81244	StartDate : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81245	EndDate : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81247	CreditCardType : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81248	Username : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81249	Password : Invalid parameter.
1508	A parameter on the payment call is invalid, check the Payment Solution Response	81250	Version : Invalid parameter.
1509	The transaction was blocked by the Payment Solution.	10203	Transaction failed, action required by user.
1509	The transaction could not be processed. Check the Payment Solution Response	10443	This transaction cannot be completed with PaymentAction of Order.
1509	The transaction could not be processed. Check the Payment Solution Response	10445	This transaction cannot be processed At this time. Please try again later.
1509	The transaction could not be processed. Check the Payment Solution Response	10486	This transaction couldn’t be completed. Please redirect your customer to PayPal.
1509	The transaction could not be processed. Check the Payment Solution Response	10505	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10507	This transaction cannot be processed. Please contact PayPal Customer Service.
1509	The transaction could not be processed. Check the Payment Solution Response	10509	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10511	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10520	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10523	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10537	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10544	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10545	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10546	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10547	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10550	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10552	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10553	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10564	This transaction cannot be processed.
1509	The transaction was blocked by the Payment Solution.	10606	Transaction rejected, please contact the buyer.
1509	The transaction could not be processed. Check the Payment Solution Response	10628	This transaction cannot be processed at this time. Please try again later.
1509	The transaction could not be processed. Check the Payment Solution Response	10634	This transaction cannot be processed at this time. Please try again later.
1509	The transaction could not be processed. Check the Payment Solution Response	10754	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10756	The transaction cannot be processed. The country and Billing address associated with this credit card do not match.
1509	The transaction could not be processed. Check the Payment Solution Response	10760	This transaction cannot be processed. The country Listed for your business address is not currently supported.
1509	The transaction could not be processed. Check the Payment Solution Response	10761	This transaction cannot be processed. Please check the Status of your first transaction before placing another order.
1509	The transaction could not be processed. Check the Payment Solution Response	10762	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10763	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	10764	This transaction cannot be processed at this time. Try again later.
1509	The transaction could not be processed. Check the Payment Solution Response	11302	The transaction was refused because you cannot send money to yourself.
1509	The transaction could not be processed. Check the Payment Solution Response	11401	The transaction cannot complete successfully Due to a failure in UATP number generation.
1509	The transaction could not be processed. Check the Payment Solution Response	11403	This transaction cannot be processed. UATP Card expired.
1509	The transaction could not be processed. Check the Payment Solution Response	11404	This transaction cannot be processed. No UATP card Exist in the system for given card number and expiration.
1509	The transaction could not be processed. Check the Payment Solution Response	11406	This transaction cannot be processed. Merchant is not designated as UATP airline.
1509	The transaction could not be processed. Check the Payment Solution Response	11407	Invalid Payment Action for UATP Airlines.
1509	The transaction could not be processed. Check the Payment Solution Response	11450	Failed to create Billing Agreement; reference transaction feature may be Unavailable or not enabled for the merchant, or a system error may have occurred.
1509	The transaction could not be processed. Check the Payment Solution Response	11457	The Reference ID refers to a transaction or order that is more than 730 days old.
1509	The transaction could not be processed. Check the Payment Solution Response	11547	Permission Denied. You are not authorized to do this kind of transaction.
1509	The transaction was blocked by the Payment Solution.	11611	Transaction blocked by your settings in FMF.
1509	The transaction could not be processed. Check the Payment Solution Response	11612	Could not process your request to accept/deny the transaction.
1509	The transaction could not be processed. Check the Payment Solution Response	11614	Could not process your request to accept/deny the transaction.
1509	The transaction was blocked by the Payment Solution.	11900	The transaction was rejected by PayPal because it failed Payment Review.
1509	The transaction was blocked by the Payment Solution.	12109	Seller blocks payments via eBay checkout for all eBay items.
1509	The transaction could not be processed. Check the Payment Solution Response	12125	There’s a problem with the redemption code(s) you entered and can’t be used at this time. Your payment has not been processed. Please go back to PayPal so that the code(s) can Be removed, your order total can be updated and then you’ll be able to complete checkout.
1509	The transaction could not be processed. Check the Payment Solution Response	12126	We’re having problems processing redemption codes at this time. Your payment has not been processed. You can try to check out again at a later time or complete your payment Without the discount applied.
1509	The transaction could not be processed. Check the Payment Solution Response	12203	Instant Payment in 3PXO cannot be pending. The transaction has been rolled back.
1509	The transaction could not be processed. Check the Payment Solution Response	12204	Error occurred causing transaction reversal.
1509	The transaction could not be processed. Check the Payment Solution Response	13107	One or more payment requests failed. Check individual payment responses for more information.
1509	The transaction could not be processed. Check the Payment Solution Response	13112	The Buyer will not be able to Pay the seller for this Transaction.
1509	The transaction could not be processed. Check the Payment Solution Response	13113	The Buyer cannot pay with PayPal for this transaction.
1509	The transaction could not be processed. Check the Payment Solution Response	13122	This transaction cannot be completed because it violates the PayPal User Agreement.
1509	The transaction could not be processed. Check the Payment Solution Response	15001	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	15002	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	15003	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	15005	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	15009	This transaction cannot be processed. All shopping cart items must be in the same currency.
1509	The transaction could not be processed. Check the Payment Solution Response	15010	This authorization can only be handled through the gateway which created it. This authorization must be captured, voided, updated or reauthorized Through the gateway.
1509	The transaction could not be processed. Check the Payment Solution Response	18014	This transaction cannot be processed.
1509	The transaction could not be processed. Check the Payment Solution Response	99998	This transaction cannot be processed.
1511	The refund was unable to be processed. Check Payment Solution Response	13531	The funding source provided for this operation is not supported. Please provide a valid value.
1511	The refund was unable to be processed. Check Payment Solution Response	13601	Refunds to users without PayPal accounts cannot exceed the transaction amount.
1511	The refund was unable to be processed. Check Payment Solution Response	13607	The Funding source provided is not usable. Please provide different funding source.
1511	The refund was unable to be processed. Check Payment Solution Response	17005	Refund transaction is already canceled.
1513	Unable to process this operation please check the Payment Solution Response	10612	Maximum number of allowable settlements has been reached. No more settlement for the authorization.
1513	Unable to process this operation please check the Payment Solution Response	10614	You can void only the original authorization, not a reauthorization.
1513	Unable to process this operation please check the Payment Solution Response	10615	You can reauthorize only the original authorization, not a reauthorization.
1513	Unable to process this operation please check the Payment Solution Response	10616	Maximum number of reauthorization Allowed for the auth is reached.
1513	Unable to process this operation please check the Payment Solution Response	10617	Reauthorization is not allowed inside honor period.
1513	Unable to process this operation please check the Payment Solution Response	10618	Transaction has already been voided or expired.
1513	Unable to process this operation please check the Payment Solution Response	10619	Invoice ID value exceeds maximum allowable length.
1513	Unable to process this operation please check the Payment Solution Response	10620	Order has already been voided, expired, or completed.
1513	Unable to process this operation please check the Payment Solution Response	10621	Order has expired.
1513	Unable to process this operation please check the Payment Solution Response	10622	Order is voided.
1513	Unable to process this operation please check the Payment Solution Response	10623	Maximum number of authorization Allowed for the order is reached.
1513	Unable to process this operation please check the Payment Solution Response	10629	Reauthorization is not allowed for this type of authorization.
1513	Unable to process this operation please check the Payment Solution Response	10635	This authorization was already reauthorized. Use the reauthorized transaction id to do an update.
1513	Unable to process this operation please check the Payment Solution Response	11094	This authorization can only be handled through the marketplace which Created it. It cannot directly be voided, reauthorized, updated or captured against.
1513	Unable to process this operation please check the Payment Solution Response	11453	Reference transaction feature not currently available; try again later.
1513	Unable to process this operation please check the Payment Solution Response	11455	Buyer did not accept billing agreement.
1513	Unable to process this operation please check the Payment Solution Response	11564	The number of failed payments should be greater Than the current number of failed payments.
1513	Unable to process this operation please check the Payment Solution Response	11567	The time of the update is too close to the billing date.
1513	Unable to process this operation please check the Payment Solution Response	11570	The maximum number of failed payments should be Greater than the current number of failed payments.
1513	Unable to process this operation please check the Payment Solution Response	11571	The total amount cannot exceed 120% increment per 180 days.
1513	Unable to process this operation please check the Payment Solution Response	11578	Recurring payment scheduled within 24 hours, So we are not processing the bill outstanding amount.
1513	Unable to process this operation please check the Payment Solution Response	11601	Billing address request is not enabled for merchant.
1513	Unable to process this operation please check the Payment Solution Response	11602	Feature not yet available.
1513	Unable to process this operation please check the Payment Solution Response	12124	Express Checkout not supported for you.
1513	Unable to process this operation please check the Payment Solution Response	12202	Only one Immediate Payment item can be paid for in a single PayPal payment transaction.
1513	Unable to process this operation please check the Payment Solution Response	12302	This transaction already has a PayPal dispute filed.
1513	Unable to process this operation please check the Payment Solution Response	13100	Parallel payments functionality is not available.
1513	Unable to process this operation please check the Payment Solution Response	13101	Payment action of Order is only supported for parallel payments.
1513	Unable to process this operation please check the Payment Solution Response	13110	Due to some technical difficulties the Multi Payments For Sale is not available now please try again later.
1513	Unable to process this operation please check the Payment Solution Response	13200	Channel not enabled for channel initiated billing.
1513	Unable to process this operation please check the Payment Solution Response	13606	You are not enabled for this feature.
1513	Unable to process this operation please check the Payment Solution Response	14001	Capture amount less than threshold.
1513	Unable to process this operation please check the Payment Solution Response	17006	Refund transaction which is in completed state cannot be canceled.
1513	Unable to process this operation please check the Payment Solution Response	81002	Method Specified is not Supported.
1513	Unable to process this operation please check the Payment Solution Response	81003	No Method Specified.
1513	Unable to process this operation please check the Payment Solution Response	81004	No Request Received.
1514	There is a problem with the URL, check the Payment Solution Response	10800	Your request is too long. Check URLs and other long strings.
1514	There is a problem with the URL, check the Payment Solution Response	11001	Exceeds maximum length.
1514	There is a problem with the URL, check the Payment Solution Response	11800	Your request is too long. Check URLs and other long strings.
1514	There is a problem with the URL, check the Payment Solution Response	11831	Callback URL is too long; it must not exceed 1,024 characters.
1520	Unsupported API request. You are not registered to use this API	10575	The API Operation is not allowed for the transaction being referenced.
1521	The account is closed	10009	Account is locked or inactive.
1521	The account is closed	10204	User’s account is closed or restricted.
1522	Your merchant account is currently inactive	10603	The buyer account is restricted.
1524	The provided transaction reference has already been used for another transaction. You must provide a unique value for each request	10206	Transaction was already processed.
1524	The provided transaction reference has already been used for another transaction. You must provide a unique value for each request	10412	Payment has already been made for this InvoiceID.
1524	The provided transaction reference has already been used for another transaction. You must provide a unique value for each request	10624	Payment has already been made for this Invoice ID.
1524	The provided transaction reference has already been used for another transaction. You must provide a unique value for each request	11577	Another outstanding payment is scheduled.
1524	The provided transaction reference has already been used for another transaction. You must provide a unique value for each request	13513	The specified Invoice ID is a duplicate.
1528	The supplied customerId is invalid	10327	The MassPay input file includes invalid UserId.
1529	Member is residing in a merchant blocked country/state/region	10565	The merchant country is not supported.
1532	Merchant is not entitled to initiate this type of transaction	10425	Express Checkout has been disabled for this merchant. Please contact Customer Service.
1532	Merchant is not entitled to initiate this type of transaction	11452	Merchant not enabled for reference transactions.
1532	Merchant is not entitled to initiate this type of transaction	13108	Merchant is not eligible for parallel payments.
1533	Insufficient balance to complete the transaction	10210	Transaction failed because has no funding sources.
1533	Insufficient balance to complete the transaction	10422	The customer must return to PayPal to select new funding sources.
1535	The specified amount is above defined maximum transfer out limits	10578	Unable to make this transaction. It is possible that the Amount would exceed the spending limit of the payer.
1535	The specified amount is above defined maximum transfer out limits	11091	The transaction was blocked as it would Exceed the sending limit for this buyer.
1538	The specified amount is too low. You must specify an amount greater than or equal to 1 unit of currency	10525	This transaction cannot be processed. The amount to be charged is zero.
1539	The specified amount is too high. You must specify an amount within your transactional limit	10414	The amount exceeds the maximum amount for a single transaction.
1539	The specified amount is too high. You must specify an amount within your transactional limit	10538	The transaction was refused because the maximum amount was exceeded as a result of your Maximum Amount Risk Control Settings.
1539	The specified amount is too high. You must specify an amount within your transactional limit	10610	Amount specified exceeds allowable limit.
1539	The specified amount is too high. You must specify an amount within your transactional limit	10625	The amount exceeds the maximum amount for a single transaction.
1539	The specified amount is too high. You must specify an amount within your transactional limit	11576	Bill amount is greater than outstanding balance.
1540	The transaction exceeds allowed account limits	10202	Transaction would exceed user’s monthly maximum
1540	The transaction exceeds allowed account limits	10305	The user account needs to have its sending Limit removed in order to make a mass payment.
1540	The transaction exceeds allowed account limits	10306	The user’s international account needs to have its sending Limit removed in order to make a mass payment.
1548	The third party processor has declined the transaction	10417	Instruct the customer to retry the transaction using an alternative payment method from the customer’s PayPal wallet. The transaction did Not complete with the customer’s selected payment method.
1548	The third party processor has declined the transaction	10457	eBay API creation error.
1548	The third party processor has declined the transaction	10458	eBay API unknown failure.
1548	The third party processor has declined the transaction	10459	eBay API error.
1548	The third party processor has declined the transaction	10460	Parsing error.
1548	The third party processor has declined the transaction	10461	Item number invalid, removed, or unavailable.
1548	The third party processor has declined the transaction	10462	Order not found.
1548	The third party processor has declined the transaction	10463	eBay user password incorrect.
1548	The third party processor has declined the transaction	10464	Item ID and Transaction ID mismatch.
1548	The third party processor has declined the transaction	10465	eBay user invalid.
1548	The third party processor has declined the transaction	10467	Duplicate Item ID.
1548	The third party processor has declined the transaction	10468	Duplicate Order Id.
1548	The third party processor has declined the transaction	10470	Solution Type passed as Sole while ExpressO feature is turned off
1549	The payment solution has declined to process the transaction	10014	The API call has been denied as it has exceeded The permissible call rate limit.
1549	The payment solution has declined to process the transaction	10069	Payment could not be completed due to a sender account issue. Please notify the user to contact PayPal Customer Support.
1549	The payment solution has declined to process the transaction	10201	Billing Agreement was canceled.
1549	The payment solution has declined to process the transaction	10205	Transaction refused due to risk model.
1549	The payment solution has declined to process the transaction	10207	Transaction failed but user has alternate funding source.
1549	The payment solution has declined to process the transaction	10209	Preapproved Payments not enabled.
1549	The payment solution has declined to process the transaction	10212	A profile preference is set to automatically deny certain transactions.
1549	The payment solution has declined to process the transaction	10301	The user is not allowed to send money through Mass Pay.
1550	Your request was not authorized as the API requires member authorization	10002	You do not have permissions to make this API call.
1550	Your request was not authorized as the API requires member authorization	10007	You do not have permissions to make this API call.
1550	Your request was not authorized as the API requires member authorization	10485	Payment has not been authorized by the user.
1551	The API is currently unavailable due to maintenance activities	10101	This API is temporarily unavailable. Please try later.
1600	Payment solution general input error, please check payment solution respond	10314	The input to the MassPay server is incorrect. Please make sure that you are using a correctly formatted input.
1600	Payment solution general input error, please check payment solution respond	10326	Verify the receiver type and ensure That no non-ascii characters are used.
1616	Incorrect CVV	10504	This transaction cannot be processed. Please Enter a valid Credit Card Verification Number.
1616	Incorrect CVV	15004	This transaction cannot be processed. Please enter a valid Credit Card Verification Number.
1620	Card Number not Valid, Please Check Payment Solution Respond	10527	This transaction cannot be processed. Please Enter a valid credit card number and type.
1620	Card Number not Valid, Please Check Payment Solution Respond	10534	This transaction cannot be processed. Please Enter a valid credit card number and type.
1620	Card Number not Valid, Please Check Payment Solution Respond	10535	This transaction cannot be processed. Please Enter a valid credit card number and type.
1620	Card Number not Valid, Please Check Payment Solution Respond	10541	This transaction cannot be processed. Please enter A valid credit card number and type.
1620	Card Number not Valid, Please Check Payment Solution Respond	10560	The issue number of the credit card is invalid.
1620	Card Number not Valid, Please Check Payment Solution Respond	10759	This transaction cannot be processed. Please Enter a valid credit card number and type.
1620	Card Number not Valid, Please Check Payment Solution Respond	15006	This transaction cannot be processed. Please enter a valid credit card number and type.
1624	Account disabled	10548	This transaction cannot be processed. The merchant’s Account is not able to process transactions.
1624	Account disabled	10549	This transaction cannot be processed. The merchant’s Account is not able to process transactions.
1624	Account disabled	11089	Account is locked or inactive.
1624	Account disabled	11545	Payer’s account is denied.
1624	Account disabled	11546	Merchant account is denied.
1628	Potencial fraud, transaction declined.	10539	Payment declined by your Risk Controls Settings: PayPal Risk Model.
1628	Potencial fraud, transaction declined.	10554	The transaction was refused.
1628	Potencial fraud, transaction declined.	10555	The transaction was refused.
1628	Potencial fraud, transaction declined.	10556	The transaction was refused.
1628	Potencial fraud, transaction declined.	10626	Transaction refused due to risk model.
1629	MPI Error, please check payment solution respond	10211	Invalid MP ID.
1631	Token Error, please check payment solution respond	10408	Token is missing.
1631	Token Error, please check payment solution respond	10409	Express Checkout token was issued for A merchant account other than yours.
1631	Token Error, please check payment solution respond	10410	Invalid token.
1631	Token Error, please check payment solution respond	10411	This Express Checkout session has expired. Token value is no longer valid.
1631	Token Error, please check payment solution respond	10415	A successful transaction has already been completed for this token.
1631	Token Error, please check payment solution respond	10416	You have exceeded the maximum number Of payment attempts for this token.
1631	Token Error, please check payment solution respond	10421	This Express Checkout session belongs to a different customer. Token value mismatch.
1631	Token Error, please check payment solution respond	11456	Transaction refused because of an invalid argument. See additional error messages for details.
1631	Token Error, please check payment solution respond	11502	The token is missing or is invalid.
1631	Token Error, please check payment solution respond	11585	Missing token or payment source.
1631	Token Error, please check payment solution respond	11607	A successful transaction has already been completed for this token.
1631	Token Error, please check payment solution respond	13116	The transaction is in progress for this token.
1631	Token Error, please check payment solution respond	81117	Token : Required parameter missing.
1634	Transaction pending to be processed by the Payment Solution	11610	Payment Pending your review in Fraud Management Filters.
1635	Invalid descryptor, please check payment solution respond	10213	The soft descriptor passed in contains invalid characters.
1635	Invalid descryptor, please check payment solution respond	10214	Soft descriptor format error.
1635	Invalid descryptor, please check payment solution respond	10215	The soft descriptor passed in was truncated.
1635	Invalid descryptor, please check payment solution respond	10217	The SoftDescriptorCity field was truncated.
1635	Invalid descryptor, please check payment solution respond	10218	Illegal characters were removed from the SoftDescriptor field.
1635	Invalid descryptor, please check payment solution respond	10219	Illegal characters were removed from the SoftDescriptorCity field.
1635	Invalid descryptor, please check payment solution respond	10220	The Merchant is not enabled to pass SoftDescriptor or SoftDescriptorCity
1636	Invalid Email Address, please check the payment solution respond	10304	The user account has unconfirmed email.
1636	Invalid Email Address, please check the payment solution respond	10317	The MassPay input file includes invalid Email.
1636	Invalid Email Address, please check the payment solution respond	10407	Invalid buyer email address (BuyerEmail).
1636	Invalid Email Address, please check the payment solution respond	10542	This transaction cannot be processed. Please enter a valid email address.
1639	Required informacion is missing, please check payment solution respond	10400	Order total is missing.
1639	Required informacion is missing, please check payment solution respond	10404	ReturnURL is missing.
1639	Required informacion is missing, please check payment solution respond	10405	CancelURL is missing.
1639	Required informacion is missing, please check payment solution respond	10419	Express Checkout PayerID is missing.
1639	Required informacion is missing, please check payment solution respond	10420	PaymentAction tag is missing.
1639	Required informacion is missing, please check payment solution respond	10430	Item amount is missing.
1639	Required informacion is missing, please check payment solution respond	10435	The customer has not yet confirmed payment For this Express Checkout session.
1639	Required informacion is missing, please check payment solution respond	10448	A confirmed email is required to make this API call.
1639	Required informacion is missing, please check payment solution respond	10472	CancelURL is missing.
1639	Required informacion is missing, please check payment solution respond	10512	This transaction cannot be processed. Please enter a first name.
1639	Required informacion is missing, please check payment solution respond	10513	This transaction cannot be processed. Please enter a last name.
1639	Required informacion is missing, please check payment solution respond	10567	A Start Date or Issue Number is required.
1639	Required informacion is missing, please check payment solution respond	10576	A customer service phone number is required to process transactions. Please add a customer service phone number to your PayPal Account or contact PayPal for more info.
1639	Required informacion is missing, please check payment solution respond	10727	The field Shipping address1 is required.
1639	Required informacion is missing, please check payment solution respond	10728	The field Shipping Address City is required.
1639	Required informacion is missing, please check payment solution respond	10729	The field Shipping Address State is required.
1639	Required informacion is missing, please check payment solution respond	10730	The field Shipping Address Postal Code is required.
1639	Required informacion is missing, please check payment solution respond	10731	The field Shipping Address Country is required.
1639	Required informacion is missing, please check payment solution respond	10747	This transaction cannot be processed without a valid IP address.
1639	Required informacion is missing, please check payment solution respond	10748	This transaction cannot be processed without a Credit Card Verification Number.
1639	Required informacion is missing, please check payment solution respond	10750	There’s an error with this transaction. Please Enter a valid state in the shipping address.
1639	Required informacion is missing, please check payment solution respond	10751	There’s an error with this transaction. Please Enter a valid state in the billing address.
1639	Required informacion is missing, please check payment solution respond	11503	Missing subscription details.
1639	Required informacion is missing, please check payment solution respond	11504	Missing schedule details.
1639	Required informacion is missing, please check payment solution respond	11549	Subscription start date is required.
1639	Required informacion is missing, please check payment solution respond	11551	Profile ID is missing from the request.
1639	Required informacion is missing, please check payment solution respond	11554	Note is missing from the request.
1639	Required informacion is missing, please check payment solution respond	11582	No scheduled payment has been found.
1639	Required informacion is missing, please check payment solution respond	11587	Billing Address is Partial.
1639	Required informacion is missing, please check payment solution respond	11825	Flat-rate shipping options are missing; you must specify flat-rate Shipping options when you specify a callback URl.
1639	Required informacion is missing, please check payment solution respond	11827	Line items missing; line items are required when you specify A callback URL for flat-rate shipping options.
1639	Required informacion is missing, please check payment solution respond	11828	Maximum amount of order not specified; you must specify the estimated Value of the order when using a flat-rate shipping option.
1639	Required informacion is missing, please check payment solution respond	11829	Shipping total is missing; you must specify a shipping Total when using a flat-rate shipping option.
1639	Required informacion is missing, please check payment solution respond	11830	Insurance amount is missing; you have offered Insurance but have not specified an amount.
1639	Required informacion is missing, please check payment solution respond	11996	To do a refund on an Adaptive Payment transaction, Please use the Adaptive Payment Refund API.
1639	Required informacion is missing, please check payment solution respond	12200	Buyer ID must be specified to process an Immediate Payment item.
1639	Required informacion is missing, please check payment solution respond	12207	Cart ID is required for Immediate Payment item.
1639	Required informacion is missing, please check payment solution respond	13102	Payment Request ID is mandatory for parallel payments.
1639	Required informacion is missing, please check payment solution respond	13115	Seller ID is mandatory for parallel payments.
1639	Required informacion is missing, please check payment solution respond	81000	Required Parameter Missing : Unable to identify parameter.
1639	Required informacion is missing, please check payment solution respond	81100	OrderTotal (Amt) : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81101	MaxAmt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81102	ReturnURL: Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81103	NotifyURL : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81104	CancelURL : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81105	ShipToStreet : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81106	ShipToStreet2 : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81107	ShipToCity : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81108	ShipToState : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81109	ShipToZip : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81110	Country : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81111	ReqConfirmShipping : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81112	Noshipping : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81113	AddrOverride : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81114	LocaleCode : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81115	PaymentAction : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81116	Email : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81118	PayerID : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81119	ItemAmt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81120	ShippingAmt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81121	HandlingAmt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81122	TaxAmt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81123	IPAddress : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81124	ShipToName : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81125	L_Amt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81126	Amt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81127	L_TaxAmt : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81128	AuthorizationID : : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81129	CompleteType : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81130	CurrencyCode : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81131	transactionID : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81132	TransactionEntity : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81133	Acct : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81134	ExpDate : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81135	FirstName : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81136	LastName : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81137	Street : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81138	Street2 : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81139	City : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81140	State : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81141	Zip : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81142	CountryCode : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81143	RefundType : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81144	StartDate : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81145	EndDate : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81146	MPID : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81147	CreditCardType : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81148	User : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81149	Pwd : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81150	Version : Required parameter missing.
1639	Required informacion is missing, please check payment solution respond	81253	Mandatory parameter missing.
1641	Card or currency not supported, please check payment solution respond	10510	The credit card type is not supported. Try another card type.
1641	Card or currency not supported, please check payment solution respond	10521	This transaction cannot be processed. Please enter a valid credit card.
1641	Card or currency not supported, please check payment solution respond	10526	This transaction cannot be processed. The currency is not supported at this time.
1641	Card or currency not supported, please check payment solution respond	10558	Your processor is unable to process the Card Type In the currency requested. Try another card type.
1641	Card or currency not supported, please check payment solution respond	10566	The credit card type is not supported.
1641	Card or currency not supported, please check payment solution respond	10605	Currency is not supported.
1641	Card or currency not supported, please check payment solution respond	10755	This transaction cannot be processed due to an unsupported currency.
1641	Card or currency not supported, please check payment solution respond	11511	This currency is currently not supported for trial amount.
1641	Card or currency not supported, please check payment solution respond	11513	This currency is currently not supported for trial shipping amount.
1641	Card or currency not supported, please check payment solution respond	11515	This currency is currently not supported for trial tax amount.
1641	Card or currency not supported, please check payment solution respond	11520	This currency is currently not supported for amount.
1641	Card or currency not supported, please check payment solution respond	11522	This currency is currently not supported for shipping amount.
1641	Card or currency not supported, please check payment solution respond	11524	This currency is currently not supported for tax amount.
1641	Card or currency not supported, please check payment solution respond	13109	The transaction cannot complete successfully. Instruct the customer to use a non AMEX card
1641	Card or currency not supported, please check payment solution respond	15007	This transaction cannot be processed. Please use a valid credit card.
1654	Restricted card	10577	This transaction cannot be processed. The merchant must not Attempt payment on this card again for this buyer.
1654	Restricted card	10752	Credit card provided cannot be used.
1655	Disallowed tran	10446	Sale is only allowed PaymentAction.
1658	Unable to auth	10600	Authorization is voided.
1658	Unable to auth	10601	Authorization has expired.
1658	Unable to auth	10602	Authorization has already been completed.
1658	Unable to auth	10604	Authorization transaction cannot be unilateral. It must Include both buyer and seller to make an auth.
1658	Unable to auth	10607	Authorization & Capture feature unavailable.
1658	Unable to auth	10611	Authorization & Capture feature is not enabled For the merchant. Contact customer service.
1659	Duplicate tran	10536	The transaction was refused as a result of a duplicate Invoice ID supplied. Attempt with a new invoice ID.
1663	Unsupported card scheme	10502	his transaction cannot be processed.Please use a valid credit card.
1663	Unsupported card scheme	15011	This credit card was issued from an unsupported country.
1663	Unsupported card scheme	15012	The CE agreement for processing Mastercard is not accepted.
1665	Invalid currency	10418	The currencies of the shopping cart amounts must be the same.
1665	Invalid currency	10444	The transaction currency specified must Be the same as previously specified.
1665	Invalid currency	10613	Currency of capture must be the same as currency of authorization.
1665	Invalid currency	10632	Currency of authorization must be the same as currency of order.
1665	Invalid currency	10633	Currency of re-authorization must be the same as currency of authorization.
1665	Invalid currency	11548	Invalid currency code, all currency codes much match.
1665	Invalid currency	11568	Invalid currency for delinquent amount.
1667	Invalid transaction	10609	Transaction id is invalid.
1676	Payment solution error, please check payment solution respond	10102	PaymentAction of Order is temporarily unavailable. Try later or use other PaymentAction.
1676	Payment solution error, please check payment solution respond	10103	Your Solution Type is temporarily unavailable. If possible, please use another Solution Type.
1676	Payment solution error, please check payment solution respond	10310	Unable to create payments for MassPay
1676	Payment solution error, please check payment solution respond	10311	Unable to submit payments for MassPay
1676	Payment solution error, please check payment solution respond	10312	The MassPay server has reported errors.
1676	Payment solution error, please check payment solution respond	11579	Payment is failing.
1676	Payment solution error, please check payment solution respond	11583	DPRP feature is unavailable.
1676	Payment solution error, please check payment solution respond	11584	Profile is not active.
1676	Payment solution error, please check payment solution respond	11586	DPRP is disabled for this merchant.
1680	The transaction was not completed in the permitted time and has expired	13114	The Buyer returned without completing the payment.
5037	There is a parameter in the request that is mandatory	10003	Missing argument
5037	There is a parameter in the request that is mandatory	10216	Transaction refused because a confirmed address is not available.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10005	Option not supported
8011	Invalid/not supported or not permitted transaction. Check Service Response	10423	This transaction cannot be completed with PaymentAction of Authorization.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10449	Order not found.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10473	Multiple Order IDs are not supported.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10475	This transaction cannot be completed With PaymentAction of Sale.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10476	Maximum number of billing agreements exceeded.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10477	More than one billing agreement Specified for reference transaction
8011	Invalid/not supported or not permitted transaction. Check Service Response	10478	Recurring payments profile description must be provided If the billing agreement type is recurring payments.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10479	Billing agreement types cannot be mixed in the same request.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10480	Invalid billing agreement type.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10481	PaymentAction of Authorization is not allowed With Unilateral and Non-Credentialed authentication.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10482	PaymentAction of Order is not allowed with Unilateral and Non-Credentialed authentication.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10557	A profile preference is set to automatically Deny certain transactions.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10570	Authorization is not supported for this funding source.
8011	Invalid/not supported or not permitted transaction. Check Service Response	10574	This card authorization verification is not a payment transaction.
8014	Expired Card	10508	This transaction cannot be processed. Please enter a valid credit card expiration date.
8014	Expired Card	10562	This transaction cannot be processed. Please Enter a valid credit card expiration year.
8014	Expired Card	10563	This transaction cannot be processed. Please Enter a valid credit card expiration month.
8016	No Card record	10519	Please enter a credit card.
8020	Service system error. Check Service Response	10006	Version is not supported
8020	Service system error. Check Service Response	10308	There is some configuration error.
8020	Service system error. Check Service Response	10309	The mass pay server is unavailable.
8020	Service system error. Check Service Response	81251	Internal Service Error.
8026	Certificate error. Check Service Response	10008	Security header is not valid.

PayPal

Introducción

Operativas admitidas

Consideraciones iniciales para operativas de PayPal

Requisitos para usar PayPal

Requisitos para clientes

Requisitos para comercios

Datos para pruebas

Entornos y endpoints: Staging y Producción

Datos requeridos y opcionales PayPal

Integración Hosted

Autorización

Petición

Parámetros de la solicitud de autorización

Respuesta

Operaciones autorizadas en 2 pasos: pre-autorización y pre-autenticación

Petición

Parámetros de la solicitud de pre-autorización y pre-autenticación

Respuesta

Payout

Petición

Parámetros de la solicitud de Payout

Respuesta

Integración Host2Host

Autorización

Petición

Parámetros de la solicitud de autorización

Respuesta

Operaciones autorizadas en 2 pasos: pre-autorización y pre-autenticación

Petición

Parámetros de la solicitud de pre-autorización y pre-autenticación

Respuesta

Payout

Petición

Parámetros de la solicitud de Payout

Respuesta

Transacciones secundarias: Captura, anulación y devolución

Captura y anulación

Petición

Parámetros de la solicitud de captura y anulación

Respuesta

Devoluciones

Petición

Parámetros de la solicitud de devolución

Respuesta

Integración JavaScript

Autorización

Obtención del authToken y renderizado del cajero

Charge

Parámetros de la solicitud charge

Respuesta

Operaciones autorizadas 2 pasos: pre-autorización y pre-autenticación

Charge, parámetros y respuesta

Respuesta

Payout

Charge, parámetros y respuesta

Respuesta

Códigos de error

Tabla de Contenidos

Productos

Ventas

Soporte técnico

Socios

SmartWiki, Impulsada por IA

Cyberpac

Consulta la documentación de las distintas secciones de integraciones:

Addon Payments

Pagos integrados en TPV