- Realizar pagos Pix únicos con PagaLeve
- Realizar pagos con Pix Parcelado (Pix en cuotas) con PagaLeve
Requisitos
Antes de comenzar, necesitas:- Una cuenta de Yuno con acceso al Dashboard
- Claves de API y un
account_id(que se encuentra en el dashboard) - Una conexión de PagaLeve configurada en tu cuenta de Yuno (consulta Connections)
Crear y gestionar clientes
Crea el cliente una sola vez usando tumerchant_customer_id externo y luego consúltalo por el id de Yuno o por merchant_customer_id, según necesites.
- Usa el endpoint Create Customer y proporciona tu propio
merchant_customer_id(el identificador único del cliente en tu sistema). La respuesta devuelveid, que es el identificador de cliente de Yuno. - Usa Retrieve Customer con el
idde Yuno. - Usa Retrieve Customer by External Id con el parámetro de consulta
merchant_customer_id.
Pago Pix único
Usa PagaLeve para aceptar un pago Pix estándar de una sola vez.- SDK de Yuno
- API directa
Paso 1: crear una sesión de checkout
Comienza creando una sesión de checkout con el endpoint Create Checkout Session.checkout_session.Paso 2: inicializar el SDK
Inicializa el SDK de Yuno (Web, Android o iOS) con el ID decheckout_session. PagaLeve aparece como una opción de pago disponible en la interfaz del SDK, usando el tipo de método de pago "PIX" para un pago único.Pago con Pix Parcelado (en cuotas)
PagaLeve admite Pix Parcelado, que permite a los clientes dividir un pago Pix en cuotas. El cliente elige el plan de cuotas en la propia página de checkout de PagaLeve: Yuno no devuelve los planes disponibles por adelantado y en la llamada Create Payment no se envía ningún dato del plan ni de las cuotas.- SDK de Yuno
- API directa
Limitaciones
- La moneda se limita a BRL.
- Pix y Pix Parcelado comparten el mismo flujo de reembolso, ambos se reembolsan de la misma manera, incluidos los motivos
DUPLICATE,FRAUDULENTyREQUESTED_BY_CUSTOMER. - PagaLeve no usa un patrón de inscripción o almacenamiento, a diferencia de NuPay. Cada pago es un checkout único.
Transiciones de estado
PagaLeve informa el estado del pago mediante webhooks, que se procesan de forma asíncrona. ParaCANCELED y EXPIRED, el webhook publica el estado directamente. Para los demás estados de éxito, primero captura el pago mediante el endpoint ProcessPayment.