Integración de paysafecard

1. ¿Qué es el Service Center de paysafecard?

   Una vez que haya enviado el formulario web se iniciará sesión directamente en el Centro de servicio técnico y se le conducirá paso a paso por la integración de paysafecard como método de pago en su tienda web. Los pasos incluyen la selección de su tipo de integración, la carga de los documentos necesarios, la integración técnica de paysafecard en su tienda online y la firma del contrato de asociado.
   

   También a la conclusión de la integración tiene a su disposición el Service Center para administrar direcciones IP, datos de acceso al sistema productivo y para realizar pruebas.

   Puede usar el Service Center en todo su alcance funcional si es usted:

   • un PSP de cobros/servicio completo, es decir, si tiene usted mismo una relación contractual con una tienda web que desea integrar paysafecard como forma de pago.
   • una tienda web que mantiene una relación contractual directa con paysafecard, pero desea utilizar el servicio de una pasarela de pago para la integración técnica de paysafecard en su tienda web.

   Si es usted una pasarela de pago, solo puede utilizar el Centro de servicio técnico para la parte de la integración técnica de paysafecard.

2. ¿Qué tipos de integración de paysafecard como método de pago existen?

   El método de pago paysafecard se puede integrar o bien directamente a través de la empresa paysafecard o indirectamente a través de un proveedor de servicios de pago verificado por paysafecard.

   Forma de integración técnica directa

   Con esta opción, la integración técnica de paysafecard como método de pago se realiza directamente con nuestro Centro de servicio técnico de paysafecard. Usted suscribe un contrato directamente con paysafecard.

   Las ventajas para usted:

   • onboarding y test de integración a través del Centro de servicio técnico de paysafecard
   • disponibilidad de códigos de muestra online en el área de descargas (integración «copy and paste»)
   • soporte directo de paysafecard
   • notificaciones directamente de paysafecard

   Formas de integración técnica indirectas

   PSP – pasarela de pago

   Con esta opción, la integración técnica de paysafecard como método de pago es realizada por una pasarela de pago verificada por paysafecard. (Si la pasarela de pago no está verificada, es necesario verificarla online a través del Centro de servicio técnico de paysafecard o bien poniéndose en contacto directamente con el equipo de ventas de paysafecard.) Usted suscribe igualmente un contrato directamente con paysafecard. Las ventajas para usted:

   • no se requiere ninguna inversión técnica por parte del socio afiliado
   • no es necesario ningún test de integración
   • Puesta en marcha tras el test de aceptación final (realizado por paysafecard)
   • soporte directo de paysafecard
   • notificaciones directamente de paysafecard

   PSP – PSP de cobros/servicio completo

   Con esta opción, la integración técnica de paysafecard como método de pago es realizada por un PSP de cobros/servicio completo verificado por paysafecard. (Si el PSP de cobros/servicio completo todavía no está verificado, es necesario verificarlo online a través del Centro de servicio técnico de paysafecard o bien poniéndose en contacto directamente con el equipo de ventas de paysafecard.) La tramitación de las transacciones y la liquidación también se realizan directamente a través del PSP de cobros/servicio completo. Usted suscribe un contrato con el proveedor de servicios de pago.

   Las ventajas para usted:

   • no se requiere ninguna inversión técnica por parte del socio afiliado
   • no son necesarios test de integración
   • Puesta en marcha tras el test de aceptación final (realizado por paysafecard)

   Sistemas de tienda: plug-in de paysafecard verificado

   Con esa opción, la integración técnica de paysafecard como método de pago es realizada mediante la compra de un plug-in verificado por paysafecard para el sistema de tienda utilizado por usted. (Si el operador del sistema de tienda todavía no está verificado, debe hacerlo online o bien a través del Centro de servicio técnico de paysafecard o bien poniéndose en contacto directamente con el equipo de ventas de paysafecard.) Usted suscribe un contrato con paysafecard.

   Las ventajas para usted:

   • escasa inversión técnica para el socio afiliado (se deben configurar los ajustes dentro del sistema de tienda)
   • no es necesario ningún test de integración
   • Puesta en marcha tras el test de aceptación final (realizado por paysafecard)
   • Soporte técnico en colaboración con el operador del sistema de tienda y paysafecard
   • notificaciones directamente de paysafecard
3. ¿Cómo se desarrolla el proceso de integración técnica de paysafecard?

   En la integración técnica de paysafecard como forma de pago nuestro Service Center le guiará a través de los siguientes pasos:

   • IP Whitelisting para el sistema de test
     En este paso indica usted sus direcciones IP que se deben autorizar para hacer test en nuestro sistema interno.
   • Datos de acceso API-Key/MRT para el sistema de test
     Recibirá de paysafecard claves REST-API para poder hacer los test de nuestra REST-API y la Merchant Reporting Tool (MRT)
   • Test de integración
     En nuestro Service Center se presentan una serie de casos de test que se realizan y se comprueban frente a nuestro sistema en tiempo real en el orden previamente establecido.
     Si desea incluir también la integración de uno de nuestros servicios «Payout» o «Refund», tras finalizar correctamente el test de integración se realiza un test de funciones en colaboración con nuestros empleados.
   • IP Whitelisting para el sistema productivo
     Una vez concluido correctamente el test de integración, le solicitamos que nos indique sus direcciones IP para el sistema productivo que deben autorizarse en nuestro servidor interno.
   • Datos de acceso API-Key/MRT para el sistema productivo
     Una vez concluida correctamente la autorización de direcciones IP, le enviaremos datos de acceso para el sistema productivo de paysafecard. A continuación le pediremos que integre también paysafecard en su sistema productivo depositando los datos de acceso REST en sus sistemas.
   • Test de aceptación
     Si ya ha finalizado usted este paso, nuestros empleados realizan una última transacción de prueba y comprueban la actualidad y la calidad del logotipo de paysafecard usado, así como los textos correspondientes.
   • Go Live
     Una vez concluido correctamente el test de aceptación por parte de nuestros empleados, paysafecard se activará como forma de pago para su tienda web y quedará así a disposición de sus clientes como método de pago.
4. ¿Qué tecnología emplea paysafecard?

   La aplicación de pago de paysafecard está basada en una interfaz REST. REST, Representational State Transfer, es un estilo de arquitectura de la World Wide Web. REST utiliza los métodos HTTP convencionales (GET, POST, PUT, DELETE, etc.).

   Adicionalmente, paysafecard ofrece una integración técnica mediante plug-in (p. ej. OpenCart, wpShopGermany, teklab, WHMCS y easy-Panel).

5. ¿De qué llamadas técnicas consta una transacción de paysafecard correcta?

   1. Creación de la transacción mediante la solicitud de POST «Initiate Payment».

   • En caso de una respuesta con http20X y el código de error 0, el cliente final es redirigido a la ventana de pago.
   • Si la respuesta da http40X o http50X y el código de error es distinto de 0, al cliente final se le muestra un mensaje de error.

   2. El cliente final es redirigido a la ventana de pago.

   • El cliente final realiza el pago introduciendo el PIN en la ventana de pago.
   • El cliente final inicia sesión en my paysafecard y realiza el pago.

   3. En cuanto se haya compensado el pago mediante un PIN válido o con my paysafecard, paysafecard envía la «Payment Notification» a la pnURL indicada por usted.

   4. Tras recibir la «Payment Notification», la transacción se finaliza mediante la solicitud de POST «Capture Payment»

   • Si la respuesta a la solicitud de POST «Capture Payment» da http20X y el código de error 0, el importe de pago pendiente de esta transacción se añade al saldo de la cuenta del cliente final en su tienda web.  
   • Si la respuesta a la solicitud de POST «Capture Payment» da http40X o http50X y el código de error es distinto de 0, al cliente final se le muestra un mensaje de error.

   5. En paralelo al envío de la «Payment Notification», tras haber introducido un PIN válido o haber pagado correctamente mediante my paysafecard, el cliente final es redirigido a la success_URL indicada por usted.

   6. Tras la redirección a la success_URL, el estado de la transacción se comprueba con la solicitud de POST «Retrieve payment details».

   • Si la respuesta a la solicitud de POST «Retrieve payment details» da http40X o http50X y el código de error es distinto de 0, al cliente final se le muestra un mensaje de error.
   • Si el estado de la transacción es «SUCCESS» (correcto), se muestra un mensaje de éxito.
   • Si el estado de la transacción es «AUTHORIZED» (tarjeta asignada), la transacción se finaliza mediante la solicitud de POST «Capture Payment».
   • Si la respuesta a la solicitud de POST «Capture Payment» da http20X y el código de error 0, el importe de pago pendiente de esta transacción se añade al saldo de la cuenta del cliente final en su tienda web.
   • Si la respuesta a la solicitud de POST «Capture Payment» da http40X o http50X y el código de error es distinto de 0, al cliente final se le muestra un mensaje de error.
6. ¿Qué estatus puede tener una transacción con paysafecard?

   INITIATED

   El estado inicial de una transacción una vez que se ha creado.

   REDIRECTED

   El cliente ha sido redirigido correctamente al panel de pago de paysafecard a fin de autorizar el pago.

   AUTHORIZED

   El PIN del cliente se ha asignado correctamente a la transacción. La transacción se puede finalizar ahora con la solicitud de POST «Capture Payment». Hasta ahora no se ha llamado a la solicitud de POST «Capture Payment».

   SUCCESS

   La transacción se ha finalizado correctamente con la solicitud de POST «Capture Payment».

   CANCELLED_MERCHANT

   Usted, como socio afiliado, ha interrumpido el pago.

   CANCELLED_CUSTOMER

   El cliente ha interrumpido activamente el pago en el panel de pago.

   EXPIRED

   El cliente no ha autorizado la transacción durante la ventana temporal o bien usted, como socio afiliado, no ha finalizado el pago durante la ventana temporal con «Capture Payment».

7. ¿Cuáles son los códigos de error más frecuentes?

   Error Code: 2001 (Initiate Payment)

   La transacción ya existe

   Error Code: 3014 (Initiate Payment)

   No hay criterios de Reporting

   Error Code: 3001 (Initiate Payment)

   El MID está inactivo

   Error Code: 2029 (Initiate Payment)

   El importe debe ser mayor de 0

   Error Code: 4003 (Initiate Payment)

   El importe sobrepasa el importe máximo permitido

   Error Code: 3034 (Initiate Payment)

   Criterios de Reporting inactivos

   Error Code: 3002 (Initiate Payment)

   La divisa no es válida

   Error Code: 2017 (Capture Payment)

   La transacción ya se ha realizado

   Error Code: 3007 (Capture Payment)

   Intento de realización una vez expirado el lapso de tiempo

   Error Code: 2002 (Capture Payment)

   La transacción no existe

   Error Code: 2010 (Capture Payment)

   El importe sobrepasa el importe asignado

   Error Code: 2006 (Capture Payment)

   La divisa no es válida para este pago

   Error Code: 3001 (Capture Payment)

   El MID está inactive

   Error Code: 10008 (General)

   Autenticación errónea

   Error Code: 10007 (General)

   Error técnico general

   Código de error: 10014 (General)

   La divisa no es válida para REST Account

8. ¿Qué se entiende por «Payment Landing Page»?

   Se trata de la ventana de pago de paysafecard a la que el cliente es redirigido al abrir una transacción con paysafecard para introducir allí su PIN de paysafecard o sus datos de usuario de my paysafecard y finalizar la transacción.

9. ¿Cuánto tiempo tiene el cliente para introducir su PIN/sus datos del usuario de my paysafecard en la ventana de pago?

   Tras crear una transacción de pago (Initiate Payment), el cliente tiene 30 minutos para introducir su PIN en la ventana de pago o bien para iniciar sesión en su my paysafecard. Si en 30 minutos no se ha introducido el PIN o no se ha realizado correctamente el inicio de sesión en my paysafecard, el estatus de la transacción cambia de «REDIRECTED» a «EXPIRED». Las transacciones con estatus «EXPIRED» han sido incorrectas, y el cliente debe crear una nueva transacción de pago.

10. ¿Qué ocurre si la solicitud «Capture Payment» se realiza más de una vez durante una única transacción?

    Tras una solicitud «Capture Payment» finalizada, la transacción queda en estatus «SUCCESS», es decir, finalizada correctamente. Si se realiza otra solicitud «Capture Payment» para esa misma transacción, se recibe la siguiente respuesta: [http400 and Error-Code = 2017]

11. ¿Cuándo se carga el PIN/la cuenta del cliente con el importe de la transacción?

    Tras una llamada «Execute Debit» finalizada correctamente, el PIN cliente o my paysafecard se carga con el importe de la transacción. Successful response = [errorcode = 0 and resultcode = 0]

12. ¿Cómo se define el concepto «Disposition Time Window»?

    La «Disposition Time Window» es un lapso de tiempo especificado en el contrato con un valor estándar de 10 minutos. Si tras asignar un PIN o my paysafecard no se finaliza la transacción dentro de dicho lapso mediante una llamada «Execute Debit», el importe reservado se vuelve a liberar en el PINo my paysafecard.

13. ¿Qué ocurre si una transacción no se finaliza con una llamada «Execute Debit»?

    Una transacción no se puede finalizar correctamente sin una llamada «Execute Debit». El importe de transacción reservado en el PIN o en my paysafecard se libera de nuevo. En este caso, la transacción es errónea.

14. ¿Se puede usar HTTPS como Payment Notification URL (pnURL)?

    Sí, si se trata de un certificado emitido por una entidad de certificación oficial (por ejemplo Thawte y Verisign).

15. ¿Dónde puedo encontrar códigos de ejemplo para el REST-API de paysafecard?

    Los códigos de ejemplo para el REST-API de paysafecard se pueden encontrar en el área de descargas de nuestro sitio web.

16. ¿Cómo puedo pasar al entorno productivo?

    Una vez finalizado correctamente el test de integración se deben realizar las siguientes tareas para el cambio al sistema productivo de paysafecard:

    • Activación de sus direcciones IP en el sistema productivo de paysafecard
    • Integrar en su sistema la clave REST-API para el sistema productivo de paysafecard
    • Inclusión en su sistema productivo de las URL de punto final facilitadas por paysafecard
    • Cambiar en su sistema productivo la URL de redirección a la URL de la ventana de pago de paysafecard

    Una vez que haya efectuado las anteriores correcciones en su sistema productivo, nuestro equipo realiza aún el test de aceptación final. A continuación se puede activar paysafecard como forma de pago para su tienda web, de forma que sus clientes la tienen a su disposición como método de pago.

17. ¿Para qué sirve el test de funciones?

    Si además de la integración de paysafecard como forma de pago en su tienda web desea incluir también la de nuestros servicios «Payout» o «Refund», tras finalizar correctamente el test de integración se realiza un test de funciones en colaboración con nuestro equipo. A tal fin, nos pondremos en contacto con usted y realizaremos juntos el test.

18. ¿Para qué sirve el test de aceptación en el sistema productivo?

    Una vez que paysafecard esté integrada correctamente también en su sistema productivo, nuestro equipo realiza un test de aceptación. Dicho test consta de una transacción de prueba y una comprobación de los logotipos y textos de paysafecard usados, a fin de garantizar una implementación de calidad de nuestra identidad corporativa y nuestras directrices de comunicación.

19. ¿Cómo funciona el test de integración en el sistema de test?

    Tras la integración del REST-API en su sistema de test, se le solicitará poner a prueba su implementación. Para ello, el Service Center le facilitará una serie de casos de prueba para garantizar la plena funcionalidad de la aplicación de pago de paysafecard.

    Estos casos de prueba descritos en detalle deben realizarse en tiempo real y en el orden prescrito por el Service Center. Los resultados de los test se comprobarán a continuación frente al sistema de test de paysafecard. A continuación recibirá un protocolo de test que resume todos los detalles del caso de prueba y le informa sobre las adaptaciones que le quedan por realizar, si procede.

20. ¿Qué son las claves REST-API?

    Para poder acceder a nuestro sistema, necesita datos de acceso. Estos se denominan «clave API». La clave API se la facilitamos nosotros, paysafecard.

    Estos datos de acceso sirven para la autenticación en nuestra interfaz REST y deben depositarse en sus sistemas en el curso de la implementación técnica de paysafecard.

    Tenga en cuenta que está usted comprometido a mantener en secreto esta clave y a protegerla contra el acceso de terceros. paysafecard no asume ninguna responsabilidad por daños que resulten de un uso abusivo de los datos de acceso.

21. ¿Para qué debo hacer que paysafecard autorice mis direcciones IP?

    Por motivos de seguridad, nuestro sistema productivo solo permite accesos desde direcciones IP autorizadas. Por tanto, le rogamos que en el paso de proceso «IP Whitelisting» nos dé a conocer las direcciones IP con las que desea acceder a nuestro sistema productivo.

22. ¿Para qué debo hacer que paysafecard autorice mis direcciones IP?

    Por motivos de seguridad, nuestros sistemas solo permiten accesos desde direcciones IP autorizadas. Por tanto, le rogamos que en el paso de proceso «IP Whitelisting» nos dé a conocer las direcciones IP con las que desea acceder a nuestro sistema de test y más adelante a nuestro sistema productivo.