Reversar transacción

Reversar transacción

Consideraciones

Para hacer uso de este servicio se deben tener las siguientes consideraciones:
  1. Utilizar el servicio en el endpoint
    1. En sandbox: https://sandbox-merchant.greenpay.me/transactions/refund
    2. En producción: https://merchant.greenpay.me/transactions/refund
  2. Este servicio solo esta disponible para transacciones realizadas por el banco BAC.
  3. Si quiere reversar una transacción con una entidad distinto al BAC, devolverá un error.
  4. Para reversar una transacción se cuenta con una semana (7días naturales) a partir del día en que se ejecutó dicha transacción.

Pasos para el uso del servicio

1. Estructura del los datos

Para consumir el servicio se debe hacer un POST con la siguiente estructura.
{
"merchantId": "{{merchantId}}",
"secret": "{{secret}}",
"bin": "XXXXXX",
"last4": "XXXX",
"authorization": "{{authorizationID}}",
"orderReference": "{{ordenReference}}"
}

Los datos que debe proporcionar son:
  1. merchantId: Es el id proporcionado por GreenPay para su comercio.
  2. secret: Es una clave proporcionado por GreenPay para su comercio.
  3. bin: Son los primeros seis dígitos del número de tarjeta utilizada para la transacción.
  4. last4: Son los últimos cuatro dígitos del número de tarjeta utilizada para la transacción. 
  5. authorizacion: Es el Authorization de la transacción que se quiere reversar.
  6. orderReference: Es el Order Reference de la transacción que se quiere reversar.

2. Realizar POST para la reversión de transacción.

Se debe enviar una solicitud HTTP de tipo POST al endpoint de reversión de transacciones con el objeto JSON especificado en la sección Estructura de Datos que contiene los datos de la transacción.

2.1 Caso de éxito del uso del servicio de reversión.

Los casos de éxito solo serán para transacciones realizadas con el banco BAC.

En el siguiente ejemplo se muestra la respuesta de éxito en formato JSON: 

Ejemplo 1 . Éxito.

{
"code": 200,
"status": "SUCCESS",
"result": {
"orderReference": "{{orderReference}}",
"refund": true
},
"errors": []
}

2.2 Caso de error del uso del servicio de reversión.

Para cualquier intento de reversión que se haga desde alguna entidad que no sea el BAC, la información no sea haya proporcionado de manera correcta o que se hayan superado el plazo establecido para realizar la reversión, generará un error en la solicitud.

En el siguiente ejemplo se muestra la respuesta del error en formato JSON, cuando se quiere hacer una reversión con una entidad distinta al BAC: 
Ejemplo 2. Error por entidad no válida.
{
"code": 400,
"status": "FAIL",
"result": {},
"errors": [
[
"transaction",
"refund not available"
]
]
}

En el siguiente ejemplo se muestra la respuesta de error en caso que los datos de la transacción proporcionados no sean los correctos o que se haya superado el plazo establecido para realizar la reversión.
Ejemplo 3. Error por datos incorrectos.
{
"code": 404,
"status": "FAIL",
"errors": [
"Error: Transaction not found"
]
}

    • Related Articles

    • Anular transacción

      Consideraciones Para hacer uso de este servicio se deben tener las siguientes consideraciones: Utilizar el servicio en el endpoint:  En sandbox: https://sandbox-merchant.greenpay.me/transactions/void En ...
    • Listar detalles de transacción

      Consideraciones Para hacer uso de este servicio se deben tener las siguientes consideraciones: Utilizar el servicio en el endpoint:  En sandbox: https://sandbox-merchant.greenpay.me/transactions/get En ...
    • 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 ...
    • Sobre tarjetas de prueba y códigos de error

      1. ¿Cuáles tarjetas se pueden utilizar en el ambiente de pruebas o sandbox? Como el ambiente de sandbox es simulado, se deben utilizar tarjetas de prueba, preferiblemente falsas. Por ello recomendamos lo siguiente: Para realizar transacciones ...
    • FAQ

      1- ¿Cuáles tarjetas se pueden utilizar en el ambiente de pruebas? En el ambiente de pruebas se deben utilizar tarjetas de pruebas, preferiblemente “falsas“. Por ello recomendamos lo siguiente: Para realizar transacciones exitosas pueden utilizar las ...