PicPay es un método de pago alternativo exclusivo de Brasil, que ofrecemos a través de Apolopag. Se trata de una aplicación para pagos móviles, que permite a los usuarios realizar transacciones financieras desde sus teléfonos. Es popular por su facilidad de uso y variedad de funciones.

Existen dos formas de integrarlo: mediante redirección o pago push.

Integración mediante redirección

Para integrarlo mediante redirección, el usuario deberá estar presente en el momento del pago, el cual deberá procesarse a través de un navegador. En primer lugar debemos generar una orden de pago.

Como identificador de servicio, debe indicarse el service_uuid del servicio de APOLOPAG que tengas activado en tu Backend de Paylands → Administrar → Servicios de pago → Listado.

Una vez generada la orden, se debe redirigir al usuario a la pantalla de pago indicando el token de la orden y en la query, el nombre del APM:

Construimos la URL de redirección reemplazando el token por el valor devuelto en la llamada anterior.

https://api.paylands.com/v1/sandbox/payment/process/{token}?apm=PICPAY

Una vez el usuario sea redirigido a esta pantalla, podrá visualizar un código QR con el que, a través de la aplicación móvil, completar el pago. Cuando complete el pago, será redirigido de vuelta a la URL OK o KO, dependiendo del resultado del pago.

Integración mediante pago push

Si el comercio prefiere hacer llegar la referencia al usuario por otro canal distinto al navegador, es posible integrar el método de pago push, el cual devolverá la referencia al servidor para que ésta pueda ser enviada al usuario. Los pagos Push con PicPay están disponibles a través de APOLOPAG.

Para ello, en primer lugar debemos generar una orden de pago, indicando nombre del usuario, email, número de identificación, número de teléfono y fecha de nacimiento.

  "extra_data": {
    "profile": {
      "first_name": "Carlos",
      "last_name": "Moreno",
      "email": "test@gmail.com",
      "document_identification_number": "659.516.937-13",
      "birthdate": "1996-01-01",
      "phone": {
        "number": "5151428089"
      }
    }
  }

A continuación, se debe lanzar la petición del pago push indicando el UUID de la orden. La respuesta contendrá el código qr con el que pagar. Este campo se incluye dentro de la transacción del pago, en el campo payment_data. A continuación se incluye un ejemplo:

"payment_data": {
    "qr_code_url": "https://paylands/picpay-example/qr-code",
    "confirmation_url": "https://paylands/picpay-example/url_confirmation",
}

Una vez se complete el pago, el comercio recibirá la notificación del pago a la URL indicada en el campo url_post al generar la orden de pago.

Pruebas

Para más información sobre cómo probar este método de pago en cada uno de sus proveedores, visitar la documentación de APOLOPAG.

Campos personalizados

Opcionalmente, dentro del objeto extra_data se puede incluir el campo payment_reason, que permite indicar una descripción del pago.

  "extra_data": {
    "payment": {
      "payment_reason": "Payment description"
    }
  }