Waterfall: Códigos de error y toma de acciones

 

TRANSFER_CREATION_ERROR = 'S000012'

 

Motivo:

 

La entidad emisora del pago no acepta las condiciones de la cuenta de destino para poder procesar el pago:

  • Cuenta con condiciones especiales

  • Cuenta no admite abonos...

 

Recomendación Unnax:

 

  1. Contactar con el cliente y preguntar sobre las condiciones de la cuenta de destino.

  2. Reintentar la operación desde una cuenta distinta a la cuenta desde la que se ha intentado emitir el pago anteriormente. 

Informar tanto de la cuenta origen desde la que se desea procesar el pago como el tipo de la transferencia.

  1. Si el error persiste, solicitar al cliente una nueva cuenta al cliente en la que depositar el dinero.

 

INVALID_DESTINATION_ACCOUNT = 'S000014' 

 

Motivo:

La cuenta de destino no es válida para aceptar pagos:

  • Cuenta inválida

  • Cuenta cancelada

  • Cuenta cerrada…

 

Recomendación Unnax:

 

Solicitar al cliente una nueva  cuenta a la que hacer el movimiento.

  

 

DAILY_LIMIT_EXCEEDED = 'S000018'

 

Motivo:

 

Se ha superado el límite diario permitido en base a las condiciones de la cuenta de origen para continuar procesando pagos

 

Recomendación Unnax:

 

  1. Reintentar la operación desde una cuenta distinta a la cuenta desde la que se ha intentado emitir el pago anteriormente. (Cuenta por defecto)

Informar tanto de la cuenta origen desde la que se desea procesar el pago como el tipo de la transferencia.

 

Unnax Improvement:

Unnax puede desactivar el servicio de payouts automáticamente de la cuenta y reintentar la operación para que ésta se procese en calidad de Instant (siempre que alguna cuenta que preste este servicio esté disponible)

Desaparecería este final de error.

 

INSTANT_PAYMENT_NOT_SUPPORTED = 'S000024'

 

Motivo:

 

La entidad de la cuenta de destino no está suscrita al servicio de Instant Payment.

(El sistema intentará por todas las cuentas disponibles con servicio instant)

 

Recomendación Unnax:

 

  • Consultar el estado de la cuenta registrada en el sistema con una llamada al método GET /api/v3/config/bank/account/{account_hash}

  • Reintentar la operación desde una cuenta distinta a la cuenta desde la que se ha intentado emitir el pago anteriormente en calidad de standard. (Cuenta por defecto)

Informar tanto de la cuenta origen desde la que se desea procesar el pago como el tipo de la transferencia (standard).

  • Habilitar la opción por la que Unnax emite el pago automáticamente desde la cuenta por defecto como standard.

 


MVX_SRC_ACCOUNT_ERROR = "S000027"

 

Motivo:

 

Dos escenarios posibles, en función de si se tiene activa o no la configuración para procesar las operaciones desde la cuenta por defecto automáticamente:

  1. No activo el procesado automático por cuenta por defecto: Ninguna de las cuentas para procesar la orden con valor mismo día está disponible, todas ellas tienen falta de fondos o no prestan servicio

  2. Activo el procesado automático por cuenta por defecto: además de las cuenta del escenario 1, la cuenta por defecto tampoco presta servicio para poder transferir la operación como standard.

 

Recomendación Unnax:

 

  1. Esperar 5’

  2. Consultar el estado de las diferentes cuentas Instant que se tienen registradas en el sistema con una llamada al método GET /api/v3/config/bank/account/{account_hash}

Revisar los campos de la respuesta: 

Consultar los detalles referentes al saldo de la cuenta, informado en el campo: data[‘current_balance’]

Consultar los detalles referentes al servicio de transferencia que presta el banco, informado en el campo:

data[‘bank_data’][‘bank_transfer’] (true si presta servicio, false si esta en mantenimiento)

  1. En caso de no poder procesarse la operación, esperar nuevamente 5’ y volver a repetir paso 2

  2. Reintentar la operación (sin informar cuenta de origen ni tipo de transferencia) si los datos de las cuentas revisadas anteriormente permiten transferir la operación.

SIGN_ERROR = 'S000007' 

 

Motivo:

 

Error genérico reservado para todos aquellos casos de error no contemplados en ninguno de los casos anteriores, nuevos casos de uso o nuevos literales mostrados por los bancos a lo largo del proceso de firma de las operaciones.

 

Recomendación Unnax:

 

  1. Contactar con el cliente y preguntar sobre las condiciones de la cuenta de destino.

  2. Reintentar la operación desde una cuenta distinta a la cuenta desde la que se ha intentado emitir el pago anteriormente. 

Informar tanto de la cuenta origen desde la que se desea procesar el pago como el tipo de la transferencia. (Instant)

  1. Si el error persiste, solicitar al cliente una nueva cuenta al cliente en la que depositar el dinero.

 

Unnax Improvement:

 

Unnax analizará los diferentes casos acumulados bajo este código de error, semanalmente, para tomar decisiones acerca del código de error al que se debe asignar los nuevos casos.

S000012 o S000014.






Waterfall: Error codes and recommended actions

 

TRANSFER_CREATION_ERROR = 'S000012'

 

Cause:

 

Payment entity doesn’t accept the conditions of the destination bank account to process the transfer:

  • Bank account with special conditions

  • Bank account doesn’t accept transfers..

 

Unnax Recommendation:

 

  1. Contact customer and ask about the conditions of the destination bank account.

  2. Retry the operation from a different origin bank account attempted previously.

Inform the origin bank account from which the transfer has to be processed and the transfer type.

  1. If received same error, request customer another destination bank account to send the money.

 

INVALID_DESTINATION_ACCOUNT = 'S000014' 

 

Cause:

 

Destination bank account is not able to accept payments:

  • Invalid bank account

  • Bank account cancelled

  • Bank account closed

 

Unnax Recommendation:

 

Request customer a different bank account to receive the money.

 

DAILY_LIMIT_EXCEEDED = 'S000018'

 

Cause:

 

The transfer daily limit for the origin bank account was exceeded from the conditions established for the bank account to process payments.

 

Unnax Recommendation:

 

  1. Retry the operation from a different bank account which was attempted previously. (Default bank account)

  2. Inform the origin bank account from which the transfer has to be retried and also the transfer type.

 

Unnax Improvement:

Unnax can deactivate the Pay Out product automatically for the bank account and retry the operation so it can be processed as instant transfer (if any bank account if available for transfer service)

This error would disappear over time.

 

 

INSTANT_PAYMENT_NOT_SUPPORTED = 'S000024'

 

Cause:

 

The destination account does not support the Instant Payment service.

(Unnax will try to transfer the order from all the available bank accounts with instant payment service before returning this error message)

 

Unnax Recommendation:

 

  1. Check the status of the account registered in the system using the GET method /api/v3/config/bank/account/{account_hash}

  2. Retry the operation from an account other than the account from which the payment has previously been attempted as standard. (Default account) (The one checked with GET)

Inform both the source account from which you would like to process the payment and also the transfer type (standard).

  1. Enable the option by which Unnax automatically issues the payment from the default account as standard.

 

MVX_SRC_ACCOUNT_ERROR = "S000027"

 

Cause:

 

There are 2 possible scenarios, depending on whether or not you have enabled the configuration to process operations from the default account automatically:

  1. Default account automatic process disabled: None of the accounts to process the order within the same day is available. All of them have insufficient funds or do not provide service. 

  2. Default account automatic process enabled: In addition to the accounts in scenario 1, the default account does not provide service to transfer the operation as standard.

 

Unnax Recommendation:

 

  1. Wait for 5 minutes.

  2. Check the status of the different Instant accounts registered in the system using the GET method /api/v3/config/bank/account/{account_hash}

  3. Review the response fields: 

Check the details regarding the account balance, reported in the field: data[‘current_balance’]

Check the details regarding the transfer service provided by the bank, informed in the field:

data[‘bank_data’][‘bank_transfer’] (true if it provides service, false if it is under maitenance)

  1. In case the operation cannot be processed, wait for more 5 minutes and repeat step 2 again.

  2. Retry the operation (without informing the source account or the transfer type) if the data from the previously reviewed accounts allow the operation to be transferred.

 

 


SIGN_ERROR = 'S000007' 

 

Cause:

 

Generic error reserved for all those error cases not covered in any of the previous cases, new use cases or new literals shown by banks throughout the process of signing operations.

 

 

Unnax Recommendation:

 

  1. Contact the client and ask about the conditions of the destination account.

  2. Retry the operation from an account other than the account from which you have previously attempted to issue the payment.

Inform both the source account from which you want to process the payment and the transfer type.

  1. If the error persists, ask the customer for a new account in which to deposit the money.

 

Unnax Improvement:

 

Unnax will analyze the different cases accumulated under this error code, periodically, to make decisions about the error code to which the new ones should be assigned.