Comunidad Slack

Requisitos Previos:

Para realizar cualquier operación en esta sección, es necesario contar con el username y tbk_user que obtienes al crear la inscripción. Si aún no dispones de estos datos, puedes obtenerlos siguiendo las instrucciones detalladas en la sección Flujo Completo.

Autorizar una transacción

Una vez realizada la inscripción, el comercio puede usar el tbkUser recibido para realizar transacciones. Para eso debes usar el método transaction.authorize(). Puedes revisar más detalles de esta operación en su documentación

transaction.authorize()

Tienda 1

Tienda 2

Campo
Valor
buy_order
Orden de compra de la tienda del mall. Este número debe ser único para cada transacción. Largo máximo: 26. La orden de compra puede tener: Números, letras, mayúsculas y minúsculas, y los signos |_=&%.,~:/?[+!@()>-. Los caracteres con signos no están soportados, como los acentos o signos no especificados.
card_detail
Objeto que contiene información de la tarjeta utilizado por el tarjetahabiente.
card_detail.card_number
Los últimos 4 dígitos de la tarjeta usada en la transacción.
accounting_date
Fecha contable de la autorización del pago.
transaction_date
Fecha completa (timestamp) de la autorización del pago. ISO 8601
details
Lista con el resultado de cada transacción de las tiendas.
details [].amount
Monto de la transacción de pago.
details [].status
Estado de la transacción (INITIALIZED, AUTHORIZED, REVERSED, FAILED, NULLIFIED, PARTIALLY_NULLIFIED, CAPTURED).
details [].authorization_code
Código de autorización de la transacción de pago.
details [].payment_type_code
Tipo de pago de la transaccion. VD = Venta Débito. VP = Venta prepago VN = Venta Normal. VC = Venta en cuotas. SI = 3 cuotas sin interés. S2 = 2 cuotas sin interés. NC = N Cuotas sin interés
details [].response_code
Código del resultado del pago, donde: 0 (cero) es aprobado. Valores posibles: 0 = Transacción aprobada Algunos códigos específicos para Oneclick son: -96: tbk_user no existente -97: Límites Oneclick, máximo monto diario de pago excedido. -98: Límites Oneclick, máximo monto de pago excedido -99: Límites Oneclick, máxima cantidad de pagos diarios excedido.
details [].installments_number
Cantidad de cuotas de la transacción de pago.
details [].commerce_code
Código de comercio del comercio hijo (tienda).
details [].buy_order
Orden de compra generada por el comercio hijo para la transacción de pago.

Obtener estado de una transacción

Permite consultar el estado de pago realizado a través de Oneclick. Retorna el resultado de la autorización. Puedes revisar más detalles de esta operación en su documentación

transaction.status()

Campo
Valor
buy_order
Orden de compra de la tienda del mall. Este número debe ser único para cada transacción. Largo máximo: 26. La orden de compra puede tener: Números, letras, mayúsculas y minúsculas, y los signos |_=&%.,~:/?[+!@()>-. Los caracteres con signos no están soportados, como los acentos o signos no especificados.
card_detail
Objeto que contiene información de la tarjeta utilizado por el tarjetahabiente.
card_detail.card_number
Los últimos 4 dígitos de la tarjeta usada en la transacción.
accounting_date
Fecha contable de la autorización del pago.
transaction_date
Fecha completa (timestamp) de la autorización del pago. ISO 8601
details
Lista con el resultado de cada transacción de las tiendas.
details [].amount
Monto de la transacción de pago.
details [].status
Estado de la transacción (INITIALIZED, AUTHORIZED, REVERSED, FAILED, NULLIFIED, PARTIALLY_NULLIFIED, CAPTURED).
details [].authorization_code
Código de autorización de la transacción de pago.
details [].payment_type_code
Tipo de pago de la transaccion. VD = Venta Débito. VP = Venta prepago VN = Venta Normal. VC = Venta en cuotas. SI = 3 cuotas sin interés. S2 = 2 cuotas sin interés. NC = N Cuotas sin interés
details [].response_code
Código del resultado del pago, donde: 0 (cero) es aprobado. Valores posibles: 0 = Transacción aprobada Algunos códigos específicos para Oneclick son: -96: tbk_user no existente -97: Límites Oneclick, máximo monto diario de pago excedido. -98: Límites Oneclick, máximo monto de pago excedido -99: Límites Oneclick, máxima cantidad de pagos diarios excedido.
details [].installments_number
Cantidad de cuotas de la transacción de pago.
details [].commerce_code
Código de comercio del comercio hijo (tienda).
details [].buy_order
Orden de compra generada por el comercio hijo para la transacción de pago.

Capturar una transacción diferida

En el caso de que tengas contratada la modalidad de Captura diferida, necesitas llamar al método capture después de llamar a authorize para finalizar la transacción. Revisa más detalles sobre esta modalidad en la documentación

transaction.captured()

Campo
Valor
authorization_code
Código de autorización de la captura diferida. Largo máximo: 6
authorization_date
Fecha y hora de la autorización.
captured_amount
Monto capturado. Largo máximo: 6
response_code
Código de resultado de la captura. Si es exitoso es 0,de lo contrario la captura no fue realizada. Largo máximo: 2

Reversar o Anular un pago

Esta operación permite a todo comercio habilitado, reversar o anular una transacción que fue generada en Oneclick. Puedes revisar más detalles de esta operación en su documentación

transaction.refund()

Campo
Valor
type
Tipo de reembolso, REVERSED o NULLIFIED, si es REVERSED no se devolverán datos de la transacción (authorization code, etc). Largo máximo: 10
authorization_code
(Solo si es NULLIFIED) Código de autorización. Largo máximo: 6
authorization_date
(Solo si es NULLIFIED) Fecha de la autorización de la transacción.
nullified_amount
(Solo si es NULLIFIED) Monto anulado. Largo máximo: 17
balance
(Solo si es NULLIFIED) Monto restante de la transacción de pago original: monto inicial – monto anulado. Largo máximo: 17
response_code
(Solo si es NULLIFIED) Código del resultado del pago, donde: 0 (cero) es aprobado. Largo máximo: 2
buy_order
(Solo si es NULLIFIED) Orden de compra generada por el comercio hijo para la transacción de pago. Largo máximo: 26.
¿Tienes alguna duda de integración?
Escríbenos por slack
slack Únete a nuestra comunidad de integradores. Nuestro equipo está ahí para ayudarte
Envíanos un mensaje
outlook Necesitas resolver algún tipo de incidencia, contáctanos a través de correo electrónico