El flujo de cobro en Flex conviene trabajarlo en tres pasos separados: construir elDocumentation Index
Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt
Use this file to discover all available pages before exploring further.
payload, inicializar el componente y capturar los callbacks del proceso.
En Checkout Web Flex, el método de pago se elige dentro del formulario. Por eso el
payload reutiliza la estructura del API de autorización enviando payment_method: {} en el objeto raíz.Panorama general
1. Construcción del payload
Arma la información de la operación, comprador, facturación y envío usando el mismo contrato base de PayIn.
2. Inicializar el componente
Crea la instancia de
FlexPaymentForms, envía nonce, payload y define cómo mostrar el formulario.3. Capturar callbacks
Procesa
responseCallback, trackingCallback y onErrorCallback según el resultado del flujo.Secuencia recomendada
Construye el payload
Prepara la operación con el mismo request de autorización ecommerce, incluyendo
payment_method: {} porque Flex resolverá el método real en pantalla.Crea la instancia
Inicializa
FlexPaymentForms con el nonce vigente y el payload ya validado desde backend.Monta el formulario
Usa
paymentForm.init(...) para renderizar el componente dentro del elemento del DOM donde quieres mostrar el checkout.Procesa la respuesta
Toma el resultado desde
responseCallback(response) y usa ese JSON como referencia principal del frontend.Confirma desde backend
Para cerrar la orden o marcar el pago como final, complementa con API de Consulta y, si aplica, con Notificaciones.
Qué respuesta debes tomar
El objeto
response recibido en responseCallback reutiliza el contrato del API de Autorización - ecommerce. La referencia exacta depende del método que el cliente eligió dentro de Flex.Guías del flujo
Construcción del payload
Revisa la estructura completa del request que Flex necesita para iniciar una operación.
Inicializar el componente
Aprende a crear la instancia, definir métodos visibles y renderizar el formulario.
Capturar funciones callback
Entiende cómo leer
responseCallback y cómo relacionarlo con cada método de PayIn.API de Consulta
Usa consulta como segunda validación backend antes de confirmar el resultado final al negocio.