Enviar request de pagos en lote

Enviar request de pagos en lote

Consideraciones

Para utilizar el servicio de pagos en lote se deben tomar en cuenta las siguientes consideraciones:
  1. Utilizar el servicio en los endpoints:
    1. Sandbox: https://sandbox-merchant.greenpay.me/bulk
    2. Producción: https://merchant.greenpay.me/bulk
  2. Tener tarjetas registradas  (tokenizadas en Greenpay) y disponibles para utilizar. Para conocer cómo crear token de tarjeta visite la sección Registro de tarjetas
  3. Tener una cuenta de sandbox o producción con Greenpay. Para crear una cuenta de sandbox visitar Crear cuenta sandbox y para la cuenta de producción debe haber finalizado el proceso con el equipo de afiliación de Greenpay (afiliacion@greenpay.me) y realizar una revisión técnica con el equipo de soporte de Greenpay (support@greenpay.me).

Pasos para uso del servicio

1. Estructura de los datos

Se debe crear un objeto JSON que tenga la siguiente estructura:
  1. {
        "merchantId":"your_merchant_id",
        "secret":"your_secret",
        "terminal":"your_terminal",
        "currency":"USD || CRC || GTQ",
        "payments":[
           {
              "orderReference":"xwr-100",
              "amount":0.00,
              "token":[
                 "the_card_token_to_use_in_your_payment"
              ],
              "name":"Full name",
              "email":"example@greenpay.me"
           },
           {
              "orderReference":"xwr-200",
              "amount":0.00,
              "token":[
                 "the_card_token_to_use_in_your_payment"
              ],
              "name":"Full name",
              "email":"example@greenpay.me"
           }
        ]
     }

Los parámetros obligatorios para crea un pago en lote son:

  1. merchantId: Proporcionado por Greenpay.
  2. secret: Proporcionado por Greenpay.
  3. terminal: Proporcinado por Greenpay.
  4. currency: Este valor debe coincidir con la moneda del terminal, es decir, si el terminal es USD entonces el parámetro currency debe ser USD.
  5. payments: Son los cobros que se van a realizar, puede ser uno o más objetos.
    1. orderReference: Identificador único de la transacción.
    2. amount: Monto que no debe ser 0.
    3. token: El token de tarjeta al que se le hará el cobro.
    4. name: Nombre del cliente.
    5. email: Correo electrónico del cliente.

2. Enviar solicitud de pagos en lote

Se debe enviar una solicitud HTTP  POST al endpoint de pagos en lote con el objeto JSON que contiene los datos de los cobros. Una vez procesada con éxito, se obtiene un objeto de tipo JSON como el siguiente:
  1. {
        "status": 200,
        "bulkId": "83be3d9d-8ebb-4cdf-a96a-c364da15bd80"
     }
El bulkId es un identificador único asociado a los cobros.

3. Respuesta en el webhook

Para  saber el resultado de cada cobro enviado en lote se debe implementar el webhook.
El webhook es un API que el comercio expone para que Greenpay envíe la respuesta de los cobros realizados.
El URL del endpoint debe ser con la siguiente estructura:
{{url base}}/bulkResume
Por  ejemplo: micomercio.com/bulkResume



    • Related Articles

    • Enviar request de pagos en lote

      Para crear una solicitud de pago masivo, se debe hacer una petición POST al endpoint de pagos masivo con la estructura del objeto tipo JSON que se muestra a continuación: { "merchantId": "your_merchant_id", "secret": "your_secret", "terminal": ...

    • Recibir la respuesta de pago en el webhook

      El webhook es un servicio web que recibe respuestas, en este caso de tipo POST en diferentes rutas, por ejemplo, para webhook.micomercio.com las rutas serían las siguientes: / : Para recibir las respuestas enviadas por el servicio de checkout ...

    • Recibir respuestas en el webhook

      El webhook es un servicio web que recibe respuestas, en este caso de tipo POST en diferentes rutas, por ejemplo, para webhook.micomercio.com las rutas serían las siguientes: / : Para recibir las respuestas enviadas por el servicio de checkout ...

    • Recibir la respuesta en el webhook

      El webhook es un servicio web que recibe respuestas, en este caso de tipo POST en diferentes rutas, por ejemplo, para webhook.micomercio.com las rutas serían las siguientes: / : Para recibir las respuestas enviadas por el servicio de checkout ...

    • Sobre tarjetas de prueba V1 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 ...