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 siguiente 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), es decir, contar con tokens de tarjetas disponibles para utilizar. Para conocer cómo crear token de tarjeta visite la sección de artículos Registro de tarjetas
  3. Tener una cuenta de sandbox o producción con Greenpay. Para crear una cuenta de sandbox puede registrarla en 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:

{
   "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 de tipo POST al endpoint de pagos en lote con el objeto json que contiene los datos de los cobros. Una vez se procesa la solicitud con éxito, se obtiene un objeto de tipo JSON como el siguiente:

{
   "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 como
{{url base}}/bulkResume
Por  ejemplo, micomercio.com/bulkResume



    • Related Articles

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

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

    • Recibir respuestas en un 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 ...

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

    • Invocar API de pago

      Consideraciones Para invocar el Api de pagos se debe considerar lo siguiente Utilizar el servicio en los endpoints: Sandbox: https://sandbox-checkout.greenpay.me/kount Producción: https://checkout.greenpay.me/kount Tener una session y token de una ...