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": ...

    • Servicio de pagos en lote - Información general

      Esta funcionalidad les permite realizar débitos a las tarjetas de sus clientes. La diferencia principal con el proceso de pago, radica en que este es un servicio para Backend, el cual permite que en una sola solicitud hacia nuestro API se debiten ...

    • Respuesta de pago en webhook

      1. Descripción Si el comercio require recibir las respuesta de los pagos o tokenización de tarjetas en un backend, ya sea, para actualizar pedidos, información o simplemente almacenar la respuesta en base de datos como respaldo, entonces debe ...

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

    • Listar pagos de suscripciones

      Para este servicio se debe consumir el siguiente endpoint: https://sandbox-merchant.greenpay.me/subscriptions/list/payments A continuación, se muestra el paso a paso para ejecutar un pago manual de una suscripción en nuestro API de forma exitosa: ...