Sobre tarjetas de prueba y códigos de error

Sobre tarjetas de prueba y códigos de error

1. ¿Cuáles tarjetas se pueden utilizar en el ambiente de pruebas o Sandbox?

Sandbox es un ambiente simulado, debido a ésto, se deben utilizar tarjetas de prueba, preferiblemente falsas. GreenPay le proporciona una lista de tarjetas de prueba que le ayudarán a realizar transacciones sin mover dinero real y así confirmar que su integración funciona correctamente. 

Las tarjetas de prueba le permiten simular varios escenarios :
  1. Transacciones o pagos efectuados correctamente (Aprobados)
  2. Transacciones o pagos no aprobados  por rechazos, fraude o datos inválidos.

Al realizar las pruebas, introduzca el número de tarjeta, digite una fecha válida como 12/26, utilice cualquier CVV de tres dígitos. 

No utilice datos de tarjetas reales para realizar pruebas. Use los números de tarjetas que aparecen a continuación:

  1. Para realizar transacciones exitosas puede utilizar las tarjetas:

    Número de tarjeta 
    Código de Respuesta (proc_code)
     Mensaje 
    4242424242424242
    00
    APROBADO
    4111111111111111
    00
    APROBADO 

  2. Para realizar transacciones con algún código de rechazo debe utilizar las siguientes:

    Número de tarjeta

    Código de error del banco (proc_code)

    Mensaje de error

    4539790114303785

    01

    REFIERASE AL EMISOR

    4319593393858768

    03

    COMERCIO INVÁLIDO

    4556500081329277

    04

    RETIRAR TARJETA

    4485970366452449

    05

    DENEGADA

    4485684474633390

    12

    TRANSACCIÓN INVÁLIDA

    4024007189880601

    13

    MONTO INVÁLIDO TRATE DE NUEVO

    4916402417466144

    14

    TARJETA INVÁLIDA

    4539935161849723

    19

    REINGRESAR TRANSACCIÓN

    4345967438617249

    31

    BANCO NO SOPORTADO

    4929639391534299

    41

    TARJETA PERDIDA

    4716178359021988

    43

    RETENER Y LLAMAR

    4094394314664828

    51

    FONDOS INSUFICIENTES

    4539610492212483

    54

    TARJETA VENCIDA RETIRE RENOVACIÓN

    4556710706281072

    55

    PIN INCORRECTO

    4556592228753727

    58

    FUNCIÓN NO PERMITIDA

    4929518506489375

    62

    ERROR AL AUTORIZAR

    4024007105223894

    63

    ERROR AL AUTORIZAR

    4716342493980323

    65

    ERROR AL AUTORIZAR

    4929597009464475

    78

    ERROR AL AUTORIZAR

    4539740270025870

    89

    TERMINAL INVÁLIDO

    4929942460623880

    91

    EMISOR NO CONTESTA

    4916869335186964

    96

    NO SOPORTADA


2. ¿Cuáles errores retorna el API de checkout o pasarela de pagos?

Toda transacción que sea rechazada ya sea por nuestro API, como por el Banco tendrá un status de respuesta con código 500.

  • Errores al crear una orden de pago.

    Mensaje de error

    Razón de rechazo

    Bank Entity doesn't exist

    Terminal enviado no existe en nuestro sistema

    Merchant doesn't exist

    El merchantId o el secret no existe en nuestro sistema


Verifique que ha configurado correctamente los credenciales del API

  • Errores al pagar una orden

  • Mensaje de error
    		Razón de rechazo
    Invalid_pan
    		El número de la tarjeta no corresponde con un número válido
    Session not exits or is wrong
    		El API no puede descifrar los datos recibidos, se ejecutó un proceso mal de cifrado de los datos de la tarjeta
    Session not found
    		El valor del parámetro session no existe en nuestro sistema.
     - Ya venció
     - No se ha creado
    Invalid token
    		El header liszt-token no coincide con el creado en el proceso de  creación de la orden de pago.
     - Ya venció
     - No se ha creado
    Invalid input syntax for uuid
    		Alguno de los valores de los parámetros recibidos no coincide con lo esperado 

3. ¿Cuáles son los códigos y mensajes de rechazo retornados para una transacción desde el banco?

Todos los códigos y mensajes de rechazo que retorna el banco, detallados en esta sección, aplican para Pagos en lote, Suscripciones, Pago con token y Checkout. 

A continuación, se listan los mensajes y códigos de rechazo por cada autorizador ( Banco Nacional, BAC o Credix)

3.1. Banco Nacional de Costa Rica (BNCR)

Código de error (proc_code)
Mensaje de error
01
Refiérase al Emisor
03
Comercio inválido
04
Retirar tarjeta
05
Denegada
12
Transacción inválida
13
Monto inválido trate de nuevo
14
Tarjeta inválida
19
Reingresar transacción
31
Banco no soportado
41
Tarjeta perdida
43
Tarjeta robada, retener
51
Fondos insuficientes
54
Tarjeta vencida retire renovación
55
Pin incorrecto
58
Transacción no permitida al adquirente
57
Transacción no permitida
62 63 65 78
Error al autorizar
89
Terminal inválido
91
Emisor no contesta
91
TIMEOUT
91
Emisor fuera de servicio
94
Datos duplicados
96
Error de sistema Trate de Nuevo

3.2. BAC Credomatic

Código de error (proc_code)

Mensaje de error

201

Refiérase al Emisor 

203

Comercio Inválido

204

Retirar tarjeta

205

Denegada

212

Transacción Inválida

213
Monto inválido Trate de Nuevo 

214

Tarjeta inválida 

219

Reingresar Transacción 

231

Banco No soportado

241
Tarjeta Perdida 

243

Retener y Llamar 

251
Denegada FI
254
Tarjeta Vencida Retire renovación

255

Pin Incorrecto

303

Duplicate request id

308

Invalid hash

278

Tran. No Encontrado

300

Duplicate transaction REFID: ######

300

Internal error REFID: ######

300

Invalid Credit Card Number REFID: ######

400

Transaction received but declined

410

Invalid Device

420

Host unavailable

3.3. Credix

Código de error (proc_code)

Mensaje de error

5

DENEGADA

3. ¿Cuáles son los códigos y mensajes de rechazo retornados para una transacción por Greenpay?


Código de error (proc_code)

Mensaje de error

Razón de rechazo

899

No se pudo efectuar la transacción: timeout - Se aplica reversión

Timeout al aplicar el sale del BAC. Se reversa la transacción.

899

TERMINAL IN SETTLEMENT PROCESS - Se aplica reversión

Error al aplicar sale del BAC. Se reversa la transacción.

994

ACCUMULATED AMOUNT EXCEEDED

Restricción de monto acumulado por tarjeta.

995

Invalid amount

Monto invalido.


fuse_blown

El Banco Nacional se encuentra fuera de servicio.


closed
El Banco Nacional se encuentra fuera de servicio.


Invalid card token

Valor de token de tarjeta invalido.

996

Transacción fraudulenta

Comportamiento del tarjetahabiente detectado como fraudulento.

993

Kount error

Datos de la transacción incorrectos. Pueden ser Tarjeta, email.

997

Element in blacklist (card, email, bin)

Datos en lista negra. Puede ser la tarjeta o el email del cliente. 

Una tarjeta se agrega automáticamente a lista negra si desde el banco se rechaza con los mensajes TARJETA PERDIDA, TARJETA ROBADA o RETIRAR TARJETA.

998

No se pudo efectuar la transacción: closed

Error de comunicación, no se procesa la transacción.

999

Transaction count exceeded.

Restricción de Cantidad de transacciones por tarjeta.



4. ¿Qué hacer cuando se reciben rechazos del banco?

Los rechazo más comunes que envía el banco suelen ser: Fondos insuficientes,  Denegada, Tarjeta Invalida, Transacción Invalida, Transacción Recibida pero Declinada, entre otros.
  1. Si el rechazo ocurre una o dos veces, nosotros recomendamos que el tarjetahabiente se comunique con su banco emisor para que revisen y validen que no hayan problemas con la tarjeta.
  2. Si el rechazo ocurre varias veces, con diferentes tarjetas y desde el banco emisor de la tarjeta indican que no tiene problemas, entonces, pueden enviar un ticket a support@greenpay.me con las referencias de las transacciones para que nosotros enviemos los datos al banco autorizador y ellos puedan validar si es un problema del banco autorizador, marca o banco emisor.
Los rechazos como: Denegada, Tarjeta Inválida o Transacción Inválida pueden corresponder a restricciones de la tarjeta en el banco emisor (cantidad de transacción por día, montos procesados por día, entre otros).
Como estos son rechazos del banco,  es necesario que GreenPay envíe la información de la transacción  al banco autorizador.

5. ¿Qué hacer cuando se reciben rechazos de Greenpay?

  1. Leer los motivos de rechazo descritos arriba.
  2. En caso de no estar claro o para más detalles, enviar un ticket a support@greenpay.me con la referencia de la orden que desea revisar.

    • Related Articles

    • Sobre la cuenta de prueba o Sandbox

      1. ¿Qué es Sandbox en Greenpay? Greenpay ofrece de manera gratuita una cuenta de pruebas o Sandbox, que permite a los comercios que deseen integrar sus servicios de pago utilizarlos en un entorno simulado. Este entorno opera de manera similar al ...

    • Anulación y reversión de transacciones

      Consideraciones Para utilizar la funcionalidad de anular o reversar transacción se debe considerar lo siguiente: El comercio debe estar habilitado, si esta deshabilitado no podrá ingresar y utilizar la funcionalidades del dashaboard. Si desconoce el ...

    • Proceso de tokenización con formulario

      Consideraciones Para utilizar el formulario de tokenización de tarjetas se debe considerar lo siguiente: El formulario está disponible en: Sandbox: http://sandbox-tokenizeform.greenpay.me/ Producción: https://tokenizeform.greenpay.me/ Se requiere ...

    • Respuesta de pago en webhook

      1. Descripción Si el comercio require recibir las respuesta de los pagos o tokenización de tarjetas en un backend, ya sea, para actualizar pedidos, información o simplemente almacenar la respuesta en base de datos como respaldo, entonces debe ...

    • Proceso de tokenización

      Consideraciones Para utilizar el servicio de tokenización se debe tomar en cuenta los siguiente: Utilizar el servicio en los endpoints: Sandbox: https://sandbox-checkout.greenpay.me/tokenize Producción: https://checkout.greenpay.me/tokenize Tener una ...