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()
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 prepagoVN = 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
Puedes revisar los códigos de respuesta de rechazo en el siguiente link
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
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.
Reversar o anular una transacción
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
Formulario de Anulación o Reversa
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.