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/ordersAPI, junto con tu Access Token de pruebaClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba.. Al utilizar la credencial de prueba, serás redirigido automáticamente al flujo del entorno sandbox.
curl
curl --location --request POST 'https://api.mercadopago.com/v1/orders' \ -H 'Authorization: Bearer <YOUR_TEST_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_user_co@testuser.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 un GET al endpoint /v1/orders/{id}API, reemplazando id por la identificación de la order, recibida en la respuesta a su creación.
¡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.