Motivos de rechazo de cargos

Por qué falló un cargo: el objeto remarks y la lista completa de motivos.

Cuando un cargo falla en el banco, en el proveedor o en las reglas de riesgo, la respuesta no es un error HTTP: el cargo existe y queda en failed. El motivo llega en el campo remarks del cargo, del intento de pago y del webhook del cargo.

"remarks": {
  "code": "INSUFFICIENT_FUNDS",
  "description": "Fondos insuficientes.",
  "customer_description": "Fondos insuficientes. Asegúrate de contar con dinero suficiente en tu método de pago.",
  "retry": false
}

• code: el motivo, en texto. Es el campo que debes usar para decidir.
• description: explicación para ti.
• customer_description: texto que puedes mostrarle al pagador.
• retry: false si OnePay considera el rechazo definitivo para ese medio de pago; true si no lo es y el cobro se puede intentar de nuevo más adelante. Es el valor que calcula OnePay para cada motivo, no una instrucción: en algunos (CURRENCY_NOT_SUPPORTED, SERVICE_IS_NOT_AVAILABLE, PROVIDER_REQUEST_INVALID) no coincide con la acción que sugiere description. En esos casos sigue description.

Mientras el cargo no tenga motivo, remarks es null.

Cuándo llega como error HTTP

Algunos motivos se detectan antes de crear el cargo y la API responde 422 con el formato de error estándar. En ese caso code es el código numérico de la tabla y code_name es el motivo en minúsculas:

422

{
  "message": "Una solicitud de pago ya se encuentra en proceso.",
  "code": 10141,
  "code_name": "request_to_pay_in_progress"
}

Los códigos numéricos 10103, 10104 y 10105 también los usan otros errores de la API con otro significado. Decide siempre por remarks.code o por code_name, no por el número.

Todos los motivos

COMPANY_TRANSACTION_LIMIT (10129) es el límite de cantidad de transacciones de tu empresa, como dice su customer_description; su description menciona el monto por un error del texto. El límite de monto es COMPANY_TRANSACTION_LIMIT_AMOUNT (10130).

remarks.code	Código numérico	description	customer_description	retry
INTERNAL_ERROR	10101	Error interno, comuníquese a nuestra línea de whatsapp para resolver el problema.	Error interno. comuníquese a nuestra línea de WhatsApp para resolver el problema.	true
CARD_CVV	10102	CVV inválido.	CVV inválido. Intenta nuevamente ingresando el número correcto.	false
INSUFFICIENT_FUNDS	10103	Fondos insuficientes.	Fondos insuficientes. Asegúrate de contar con dinero suficiente en tu método de pago.	false
CARD_NUMBER	10104	Número de tarjeta inválido.	Número de tarjeta inválido. Intenta nuevamente ingresando el número correcto.	false
FRAUDULENT	10105	Transacción fraudulenta.	Esta transacción ha sido reportada. Por favor, comunícate con tu banco para obtener más información.	true
STOLEN	10106	Tarjeta robada.	Tarjeta reportada, comunícate con el banco para obtener más información.	true
CURRENCY_NOT_SUPPORTED	10107	Moneda no soportada.	Moneda no soportada. Por favor, contacta a tu banco para más detalles.	true
CARD_VELOCITY	10108	Se ha excedido la cantidad de intentos de pago permitidos para esta tarjeta.	Se ha excedido la cantidad de intentos de pago permitidos para esta tarjeta.	true
CARD_DATE	10109	Fecha de expiración inválida.	Fecha de expiración inválida. Intenta nuevamente ingresando el número correcto.	false
TRANSACTION_NOT_FOUND	10110	Transacción no encontrada.	Transacción no encontrada.	true
MIN_AMOUNT	10111	El monto de la transacción es menor al mínimo permitido.	El monto de la transacción es menor al mínimo permitido. Por el método de pago.	true
ACCOUNT_NOT_CONNECTED	10112	El usuario ha desconectado su cuenta.	No pudimos procesar el pago porque tu entidad bancaria desconectó la cuenta asociada. Por favor, reconecta tu método de pago y vuelve a intentarlo.	false
ACCOUNT_BLOCKED	10113	La cuenta ha sido bloqueada.	La cuenta ha sido bloqueada. Por favor, comunícate con tu banco para obtener más información.	false
ACCOUNT_CLOSED	10114	La cuenta ha sido cerrada.	La cuenta ha sido cerrada. Por favor, comunícate con tu banco para obtener más información.	false
ACCOUNT_DOES_NOT_BELONG_TO_CUSTOMER	10115	La cuenta no pertenece al usuario.	La información del titular de la cuenta no coincide con la información del usuario.	false
TRANSACTION_EXPIRED	10116	El usuario no ha completado la transacción en el tiempo permitido.	La transacción no ha completado en el tiempo permitido, intenta nuevamente.	false
CARD_GENERIC_ERROR	10117	Error genérico al procesar el pago con tarjeta, el banco no proporcionó más información.	Error al procesar el pago. Intenta nuevamente o comunícate con tu banco para obtener más información.	true
TRANSACTION_REJECTED	10118	El usuario no acepto o rechazo la transacción en el banco.	Transacción rechazada por el banco. Comunícate con tu banco para obtener más información.	true
UNKNOWN	10119	Ha ocurrido un inconveniente inesperado. Por favor intenta nuevamente en unos minutos o contáctanos si el problema persiste.	Ha ocurrido un inconveniente inesperado. Por favor intenta nuevamente en unos minutos o contáctanos si el problema persiste.	true
BANK_IS_NOT_AVAILABLE	10120	El banco no se encuentra disponible para iniciar la transacción.	Error por parte del banco al procesar el pago. Comunícate con tu banco para obtener más información.	true
CARD_RESTRICTED	10121	Tarjeta restringida, Pídele al usuario que se comunique con su banco.	Tarjeta restringida, comunicate con el banco para resolver el problema.	true
CARD_EXPIRED	10122	Tarjeta expirada, Pídele al usuario que actualice su tarjeta.	Tarjeta expirada, actualiza tu tarjeta e intenta el pago nuevamente.	false
ACCOUNT_IS_NOT_AUTHORIZED	10123	La cuenta no está autorizada para realizar cargos.	Tu cuenta no está autorizada. Por favor, comunícate con tu banco para obtener más información.	false
TRANSACTION_TEMPORALLY_BLOCKED	10124	La transacción no se envió al banco: la tarjeta tiene rechazos recientes en este comercio y debe esperar antes de otro intento, hasta 30 días. Mientras tanto se puede cobrar con otro medio de pago.	No pudimos procesar el pago con esta tarjeta por ahora. Usa otro medio de pago o vuelve a intentarlo más adelante: la espera puede ser de hasta 30 días.	false
ACCOUNT_FAILED	10125	Los datos proporcionados sobre la cuenta son incorrectos.	No se aceptó la conexión con la cuenta. Agrega nuevamente la cuenta y vuelve a intentarlo.	false
CUSTOMER_DATA_INVALID	10126	Datos del cliente inválidos.	Datos del usuario inválidos. Por favor, verifica tu información de usuario y vuelve a intentarlo.	true
MAX_AMOUNT	10127	La transacción supera el monto máximo permitido, para este método de pago.	La transacción supera el monto máximo permitido, para este método de pago.	false
DONT_HONOR	10128	El banco está rechazando la transacción sin dar una razón específica.	Transacción rechazada por el banco. Comunícate con tu banco para obtener más información.	true
COMPANY_TRANSACTION_LIMIT	10129	La transacción excede el límite de monto permitido para la empresa.	Número de transacciones excedido. Comunícate con soporte para solucionar este problema.	false
COMPANY_TRANSACTION_LIMIT_AMOUNT	10130	La transacción excede el límite de monto permitido para la empresa.	El monto de la transacción excede los límites establecidos. Comunícate con soporte para solucionar este problema.	false
CUSTOMER_WALLET_NOT_FOUND	10131	La billetera del cliente no fue encontrada.	Agrega nuevamente el método de pago y vuelve a intentar el pago.	false
RISK_CONTROL	10132	La transacción ha sido bloqueada por el control de riesgo del banco.	La transacción ha sido bloqueada por el banco. Comunícate con tu banco para resolver el problema.	true
ACCOUNT_MAX_AMOUNT	10133	La transacción supera el monto limite autorizado por el banco para el usuario.	La transacción supera el monto limite autorizado por el banco para el usuario.	false
ACCOUNT_SERVICE_NOT_AVAILABLE	10134	La cuenta del usuario no tiene el servicio PSE activo.	La cuenta del usuario no tiene el servicio PSE activo.	false
TRANSACTION_FAILED	10135	La transacción ha fallado, por favor intente nuevamente.	Vuelve a intentarlo nuevamente o comunícate con soporte para solucionar este problema.	false
TRANSACTION_OTP_INVALID	10136	El OTP de la transacción es inválido, por favor intente nuevamente.	El OTP de la transacción es inválido, por favor vuelve a intentarlo nuevamente.	false
TARGET_DESTINATION_WALLET	10137	La billetera de destino no fue encontrada.	Error al procesar la transacción. Comunícate con soporte para solucionar este problema.	false
SECURITY_VIOLATION	10138	La transacción fue rechazada porque no cumplió con los protocolos de seguridad, No se procesó el pago. Recomienda al cliente revisar sus datos o contactar a su banco antes de volver a intentar el pago.	La transacción ha sido bloqueada por el banco. Comunícate con tu banco para resolver el problema.	false
CUSTOMER_EMAIL_RESTRICTED	10139	El correo electrónico del cliente no está permitido para realizar transacciones.	El correo electrónico del cliente no está permitido para realizar transacciones.	false
REQUEST_TO_PAY_NOT_AVAILABLE	10140	La cuenta no se encuentra disponible para realizar transacciones por solicitud de pago.	La cuenta no se encuentra disponible para realizar transacciones por solicitud de pago.	false
REQUEST_TO_PAY_IN_PROGRESS	10141	Una solicitud de pago ya se encuentra en proceso.	Una solicitud de pago ya se encuentra en proceso.	false
AMOUNT_DONT_MATCH	10142	El monto recibido no concuerda con el valor esperado.	El monto recibido no concuerda con el valor esperado.	false
SERVICE_IS_NOT_AVAILABLE	10143	El servicio de PSE no está disponible en este momento. Por favor, inténtelo más tarde.	El servicio de PSE no está disponible en este momento. Por favor, inténtelo más tarde.	false
PAYMENT_METHOD_ENVIRONMENT_MISMATCH	10144	El método de pago no corresponde al ambiente del cargo.	El método de pago no corresponde al ambiente del cargo.	false
TEST_CARD_NO_PATTERN	10145	Tarjeta de prueba sin patrón configurado.	Tarjeta de prueba sin patrón configurado.	false
CANCELLED_BY_MERCHANT	10146	El cargo fue cancelado por la empresa.	El cargo fue cancelado.	false
CUSTOMER_APPROVAL_EXPIRED	10147	El cliente no respondió la solicitud de aprobación en el tiempo permitido.	La solicitud de aprobación ha expirado. Si deseas continuar, solicita un nuevo cobro.	false
TRANSACTION_OTP_EXPIRED	10148	El OTP de la transacción ha expirado, por favor inicie nuevamente el proceso.	El código OTP ha expirado. Por favor, inicia nuevamente el proceso de pago.	false
CARD_3DS_FAILED	10149	La verificación 3DS de la tarjeta falló: el pagador no completó o no superó la autenticación del banco.	No pudimos verificar tu tarjeta con el banco. Intenta nuevamente o usa otra tarjeta.	true
REQUEST_TO_PAY_PAYER_INVALID	10150	El proveedor rechazó el registro del pagador asociado a la cuenta; ya fue restablecido, intenta el cobro nuevamente.	No pudimos procesar el pago con tu cuenta. Por favor intenta nuevamente.	true
DIRECT_DEBIT_NOT_AUTHORIZED	10151	La autorización de débito automático de la cuenta ya no es válida; se pedirá una nueva al cliente en el próximo intento.	Tu autorización de débito automático ya no está activa. Vuelve a intentar el pago y acepta la nueva solicitud en tu app.	true
PROVIDER_REQUEST_INVALID	10152	El proveedor rechazó la petición del cobro por un dato mal formado. Es un defecto nuestro, no de la tarjeta: revisar el detalle del cobro.	No pudimos procesar el pago por un problema nuestro, no de tu tarjeta. Ya estamos avisados; vuelve a intentarlo en unos minutos.	true
INSTALLMENTS_NOT_SUPPORTED	10153	La tarjeta es débito y no admite cuotas: cobrar a una sola cuota.	Tu tarjeta es débito y no admite pago a cuotas. Vuelve a intentarlo eligiendo una sola cuota.	false
MERCHANT_NOT_CONFIGURED	10154	El comercio no está activo o no está bien dado de alta en el proveedor. Revisar su configuración antes de reintentar.	El comercio todavía no puede recibir pagos con tarjeta. Avísale para que revise su configuración e inténtalo más tarde.	true
PROVIDER_UNDER_CONTINGENCY	10155	El proveedor está en contingencia y no pudo procesar la transacción. Se puede reintentar cuando restablezca el servicio.	El servicio de pagos presenta una interrupción temporal. No es un problema de tu cuenta: vuelve a intentarlo más tarde.	true