SDKs

Introducción

El SDK de Addon Payments está diseñado para proporcionar una integración fácil, rápida y flexible de los pagos en tu comercio online. Con este SDK, puedes integrar la pasarela de pago de Addon Payments en distintos lenguajes de programación, utilizando una variedad de librerías, herramientas y documentación.

El SDK te permite implementar nuestra pasarela de pago de varias maneras: Hosted, Host2Host y JavaScript. Además, podrás realizar diversas operativas: autorizaciones, pagos recurrentes, etc., con distintas soluciones de pago: tarjetas de crédito y Quix. Consulta la sección de Operativas soportadas para más detalles.  También encontrarás librerías para recibir y procesar las notificaciones, así como herramientas para el renderizado del cajero y redirección.

El SDK te proporciona potencia junto a una estructura clara de clases y métodos que facilitan su uso. También se permite la extensión de las funcionalidades del SDK mediante el uso de operativas funcionales, como parámetros extras, para adaptarse a necesidades específicas.

Enlaces GitHub a los SDKs

Estos son los enlaces a los SDKs en GitHub. La documentación sobre el funcionamiento de los mismos la encontrarás junto al SDK. En la documentación, podrás conocer los pasos previos de configuración según el lenguaje y el funcionamiento de las distintas operativas.

PHP

JAVA

.NET icon

.NET

PYTHON

Requisitos generales

Para poder utilizar los SDKs, tu comercio electrónico o plataforma deberá disponer de una URL pública que sirva como endpoint, que se encargará de recibir notificaciones, gestionar estados, etc.

Además, aquí tienes los requisitos generales de uso del SDK según cada lenguaje. 

PHP:

  • Versión 8.0 o superior. 
  • Recomendamos utilizar Composer.

.NET:

  • Versión 8.0 o superior.

Java:

  • Si utilizas Gradle, la versión del JDK debe ser inferior a la 22.

Gradle

Edita tu archivo build.gradle file.

1. Añade a la sección de repositorios:

				
					maven { 
            url = System.getenv("CGP_JAVASDK_URL") ?: uri( 
"https://maven.pkg.github.com/DeveloperCGP/Java-SDK") 
        credentials { 
                username = System.getenv("CGP_JAVASDK_USERNAME") ?: "DeveloperCGP" 
                password = System.getenv("CGP_JAVASDK_TOKEN") ?: 
"ghp_AViip9V8DaJgu1tAzuz4dSpwXy8Hoe1ana8x" 
            } 
}

2. Añade a la sección de dependencias la siguiente línea:

implementation("com.comerciaglobalpayments:java-sdk:01.00.00")

3. Construye tu proyecto.

Maven

1. Añade esto a pom.xml

				
					<dependency>
    <groupId>com.comerciaglobalpayments</groupId>
    <artifactId>java-sdk</artifactId>
    <version>01.00.00</version>
</dependency>

2. Lanza mediante esta línea de comando:

$ mvn install

Ejemplos de operativas soportadas

En esta sección encontrarás los ejemplos que hay en el SDK de operativas soportadas. Todas las operativas de la documentación de los 3 tipos de integraciones están soportadas por el SDK, pero en el SDK sólo tienes ejemplos de las que puedes ver a continuación. Te recomendamos que compruebes que el SDK funciona correctamente probando los ejemplos sin modificar. 

Con el SDK puedes trabajar con todas las integraciones: Hosted, Host2Host y JavaScript.

Pagos con tarjeta de crédito

Hosted:

  • Autorización
  • Alta de pago recurrente

Host2Host:

  • Autorización
  • Pre-autorización
  • Alta de pago recurrente
  • Pago recurrente
  • Captura
  • Cancelación
  • Devolución

JavaScript:

  • Obtención del authToken
  • Autorización (charge)
  • Alta de pago recurrente

Pagos con Quix

Hosted:

  • Artículos
  • Servicios
  • Vuelos
  • Alojamientos

    JavaScript:

    • Obtención del authToken
    • Charge de artículos
    • Charge de servicios
    • Charge de vuelos
    • Charge de alojamientos

    Flujo de operaciones en el SDK

    En esta sección encontrarás el flujo general que siguen las operativas en el SDK. Esto es una descripción básica, en la documentación del GitHub podrás ver en detalle la explicación los distintos pasos dependiendo de la operativa y del lenguaje de programación que estés usando. 

    El flujo general independientemente de la integración, operativa y lenguaje de programación es el siguiente: 

    1. Establecer las credenciales: Estableces las credenciales de tu comercio en un lugar común una única vez, para que las puedas usar en distintos ejemplos y operativas. Estos datos son necesarios para cualquier operación: merchantId, contraseña de comercio, productId, entre otros. 

    2. Establecer parámetros de pago: Estableces los parámetros que dependen más de la operativa que estés realizando (autorización, devolución, etc.). Estos datos varían de un tipo de operación a otro, como el importe o el identificador de cliente, entre otros. 

    3. Envío de la petición: Envío de la petición con las credenciales y parámetros de pago que has configurado previamente. 

    4. Gestión de la respuesta: Estableces el manejo de la respuesta, como la obtención de la URL de redirección para el cliente, el estado de la transacción o posibles errores. 

    Recuerda que en el SDK cuentas con una clase de Webhook que te ayudará a recibir y analizar las notificaciones que recibes de Addon Payments. Consulta la documentación del GitHub para más información. 

    Comparte este documento
    Tabla de Contenidos

    Enlaces .NET

    Código fuente
    Repositorios de paquete

    Enlaces PYTHON

    Código fuente
    Repositorios de paquete

    Cyberpac

    Consulta la documentación de Cyberpac. Aquí tienes las distintas secciones:

    Canales

    Módulos de integración

    Integraciones a medida

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

    Comienza a integrar

    undraw_add_to_cart_re_wrdo 1 (1) (1)

    Plugins para CMS

    Complementa la integración

    SDKs

    Métodos de pago

    Herramientas

    Addon Payments

    Consulta la documentación de Addon Payments. Aquí tienes las distintas secciones:

    Integraciones

    Consultas frecuentes

    Portal Backoffice

    Pagos integrados en TPV

    Crea una solución que te ayudará a automatizar procesos. Incluso, podrás agregar procesos de pago en terminales físicos.

    Pago integrado con TPV Android

    Pago integrado con Smartphone TPV

    Fichas Técnicas TPVs