Reversar transacción

Reversar transacción

Consideraciones

Para utilizar este servicio, es importante tener en cuenta lo siguiente:
  1. Utilizar el servicio en el endpoint correspondiente: 
    1. Para entornos de prueba (sandbox): https://sandbox-merchant.greenpay.me/transactions/refund
    2. Para entornos de producción: https://merchant.greenpay.me/transactions/refund
  2. Este servicio esta disponible únicamente para transacciones realizadas a través del banco BAC.
  3. Si intenta reversar una transacción con una entidad distinto al BAC, devolverá un error.
  4. La reversión de una transacción debe realizarse dentro de un plazo de una semana (7 días naturales) a partir de la fecha en que se ejecutó la 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:
  1. {
      "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. Esta solicitud debe incluir 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.

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

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

Cualquier intento de reversión que se haga desde una entidad que no sea el BAC, con información proporcionada incorrectamente, o después de que haya expirado el plazo establecido para realizar la reversión, resultará en 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.
  1. {
      "code": 400,
      "status": "FAIL",
      "result": {},
      "errors": [
          [
              "transaction",
              "refund not available"
          ]
      ]
    }

En el siguiente ejemplo se muestra la respuesta de error en caso de que los datos de la transacción proporcionados no sean los correctos o si ha expirado el plazo establecido para realizar la reversión.
Ejemplo 3. Error por datos incorrectos.
  1. {
      "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 producción: ...

    • 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 producción: ...

    • 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? 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 ...

    • 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 ...