Realizar una compra de prueba con PSE
Para probar tu integración con PSE deberás crear una order. Esto significa que solo podrás verificar el funcionamiento de tu integración a través del simulador bancario en el entorno sandbox, y no simulando una compra. En este entorno podrás seleccionar un escenario de pago para probar el flujo de tu integración.
Para realizar estas pruebas, envía la siguiente solicitud al endpoint /v1/ordersPOST, junto con tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.. Al utilizar la credencial de prueba, serás redirigido automáticamente al flujo del entorno sandbox.
curlcurl --location --request POST 'https://api.mercadopago.com/v1/orders' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'Content-Type: application/json' \ -d '{ "type": "online", "total_amount": "5000", "external_reference": "ext_ref_1234", "processing_mode": "automatic", "expiration_time": "PT20M", "payer": { "email": "test_payer@example.com", "entity_type": "individual", "identification": { "type": "CC", "number": "76262349" }, "first_name": "John", "last_name": "Doe", "phone": { "area_code": "57", "number": "3001234567" }, "address": { "street_name": "Calle 10", "street_number": "100", "city": "Bogota", "zip_code": "110111", "neighborhood": "Centro" } }, "transactions": { "payments": [ { "amount": "5000", "payment_method": { "id": "pse", "type": "bank_transfer", "financial_institution": "1051" } } ] }, "additional_info": { "payer.ip_address": "200.100.50.25" }, "config": { "online": { "callback_url": "https://merchant.com/pse/return" } } }'
La respuesta devolverá el estado action_required con status_detail=waiting_transfer, junto con la redirect_url para finalizar el pago de prueba en el banco.
json{ "id": "ORDOMG01KNSWP75YHQJ9EKKB13QCFF25", "total_amount": "5000", "total_paid_amount": "0", "status": "action_required", "status_detail": "waiting_transfer", "config": { "online": { "callback_url": "https://merchant.com/pse/return" } }, "transactions": { "payments": [ { "payment_method": { "id": "pse", "type": "bank_transfer", "financial_institution": "1051", "redirect_url": "https://www.mercadopago.com.co/sandbox/payments/156166999227/bank_transfer?caller_id=2676136474&hash=6df616a0-69cc-485b-a3be-f301a02dfd7a&from_pse=true" } } ] } }
La redirect_url devuelta es aquella que, en entornos productivos, usarás para redirigir al comprador a realizar la transferencia. En sandbox, esa URL abre el simulador bancario de Mercado Pago, que permite probar distintos escenarios de pago.
Luego de la redirección a la redirect_url, el flujo de simulación bancaria ocurrirá de la siguiente manera:
- Primero, el simulador mostrará la página de autenticación del banco de prueba ("Banco Prueba PSE", por ejemplo). Para avanzar, ingresa cualquier usuario y contraseña.

- Tras el inicio de sesión, la siguiente pantalla mostrará los datos de la transacción: su identificador, el identificador del pago, la fecha del pedido, la URL de la plataforma de pago y el monto a pagar.

- El menú desplegable mostrará todos los escenarios de prueba disponibles, como aprobación, abandono, cuenta inactiva, fondos insuficientes, entre otros. Selecciona el escenario que deseas simular y haz clic en Enviar.

- Después de seleccionar el escenario y enviarlo, la pantalla mostrará el resultado de la transacción. Haz clic en Volver al comercio para continuar el flujo.

- Por último, el usuario será redirigido al ticket de Mercado Pago y, a continuación, automáticamente a la
callback_urlconfigurada al crear la order.

Por último, y para verificar que la compra de prueba se realizó correctamente, envía una solicitud al endpoint /v1/orders/{id}GET, reemplazando id por la identificación de la order, recibida en la respuesta a su creación.
Como alternativa, puedes consultar el resultado del pago desde tu aplicación. Para hacerlo, dirígete a Integraciones y selecciona la card de la aplicación. Asegúrate de que el selector del margen superior tenga seleccionado Prueba y, en la pantalla Inicio, selecciona la pestaña Pagos de prueba. Luego, busca el pago realizado y haz clic sobre él para consultar sus detalles y estado.
¡Listo! Una vez finalizados estos pasos, la integración de PSE como medio de pago estará completa y podrás, o bien continuar probando otros medios de pago integrados, o bien salir a producción.