Servicios

Introducción

Los servicios (categorizados como services dentro del SDK) son los responsables de efectuar la comunicación con los servicios de PixelPay. Al utilizar los servicios, facilmente se construye la solicitud, que luego es enviada a los servidores.

Dentro de los servicios están:

  • Transaction: utilizando este servicio se pueden crear, autorizar, capturar, anular u obtener el estado de todo tipo de ventas dentro del comercio
  • Tokenization: utilizando este servicio se pueden tokenizar, actualizar, eliminar, u obtener distintas tarjetas de crédito / débito dentro del comercio

Los servicios son muy útiles ya que generan las solicitudes a la API de PixelPay.

Estos servicios emiten dos tipos de excepciones (categorizadas como exceptions dentro del SDK) que puedes capturar:

  • InvalidCredentialsException
  • InvalidTransactionException

Puede ser que la solicitud falle al intentarse comunicarse con los servicios de PixelPay, por eso importante siempre cubrir el bloque de código en un try/catch.

Transacción Transaction

El servicio de transacciones de PixelPay permite obtener el estatus de pagos, crear nuevos pagos, autorización y capturas de pagos, y anulación de pagos.

Todos los distintos servicios utilizan un tipo de petición diferente dependiendo del tipo de accion que se quiere realizar con PixelPay. Puedes identificar que tipo de servicio corresponde a cada petición viendo el nombre del archivo o la clase (ej. CardTokenization es una petición para el servicio de Tokenization)

Inicialización de Transaction

Constructor Parámetros Acceso
default settings: Settings public

Constructor por defecto utilizado para inicializar servicio de transacción.

Métodos de Transaction

Función Parámetros Retorno Acceso
doSale transaction: SaleTransaction Response public

Enviar y procesar transacción de venta.

Puedes usar la entidad TransactionResult con el resultado de este método.
Función Parámetros Retorno Acceso
doAuth transaction: AuthTransaction Response public

Enviar y procesar transacción de autenticación.

Puedes usar la entidad TransactionResult con el resultado de este método.
Función Parámetros Retorno Acceso
doCapture transaction: CaptureTransaction Response public

Enviar y procesar transacción de captura, luego de haber realizado una transacción de autenticación.

Puedes usar la entidad TransactionResult con el resultado de este método.
Función Parámetros Retorno Acceso
doVoid transaction: VoidTransaction Response public

Enviar y procesar transacción de anulación de pago, luego de haber realizado una transacción de autenticación.

Puedes usar la entidad TransactionResult con el resultado de este método.
Función Parámetros Retorno Acceso
getStatus transaction: StatusTransaction Response public

Obtener estatus actual de la transacción.

Función Parámetros Retorno Acceso
verifyPaymentHash hash: string
order_id: string
secret: string		 boolean public

Comparar el valor hash (o payment_hash dentro de la respuesta) a fin de verificar que la transacción es real.

Este método solo se puede utilizar del lado del servidor y no del lado del cliente, ya que utilizarlo del lado del cliente expondría tu llave secreta al público. El parámetro secret no debe de ingresarse encriptado.

Tokenización Tokenization

El servicio de tokenización de PixelPay permite almacenar información de tarjetas de forma segura utilizando un servicio de tokens en lugar de datos crudos de la tarjeta.

Todos los distintos servicios utilizan un tipo de petición diferente dependiendo del tipo de accion que se quiere realizar con PixelPay. Puedes identificar que tipo de servicio corresponde a cada petición viendo el nombre del archivo o la clase (ej. CardTokenization es una petición para el servicio de Tokenization)

Inicialización de Tokenization

Constructor Parámetros Acceso
default settings: Settings public

Constructor por defecto utilizado para inicializar servicio de tokenización.

Métodos de Tokenization

Función Parámetros Retorno Acceso
vaultCard card: CardTokenization Response public

Guardar la tarjeta de crédito / débito y obtener un identificador de tarjeta simbólica (formato T-*).

Puedes usar la entidad CardResult con el resultado de este método.
Función Parámetros Retorno Acceso
updateCard token: string
card: CardTokenization		 Response public

Actualizar la tarjeta de crédito / débito por identificador de tarjeta simbólica (T-*).

Puedes usar la entidad CardResult con el resultado de este método.
Función Parámetros Retorno Acceso
showCard token: string Response public

Mostrar metadatos de tarjetas de crédito / débito por identificador de tarjeta simbólica (T-*).

Función Parámetros Retorno Acceso
showCards tokens: string[] Response public

Mostrar metadatos de tarjetas de crédito / débito por varios identificadores de tarjeta simbólica (T-*).

Función Parámetros Retorno Acceso
deleteCard token: string Response public

Eliminar los metadatos de la tarjeta de crédito / débito mediante el identificador de la tarjeta simbólica (T-*).