Realizar compra de prueba con Pix
Para probar tu integración con Pix deberás crear una order con valores predefinidos. Esto quiere decir que sólo será posible verificar el funcionamiento de tu integración mediante una requisición, y no simulando una compra. Para ello, sigue los pasos a continuación.
Para realizar estas pruebas, envía la siguiente solicitud al endpoint /v1/ordersPOST, junto con su 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`..
curlcurl --request POST \ --url https://api.mercadopago.com/v1/orders \ --header 'Content-Type: application/json' \ --data '{ "type": "online", "external_reference": "ext_ref_1234", "total_amount": "50.00", "payer": { "email": "test_payer@example.com", "first_name": "APRO" }, "transactions": { "payments": [ { "amount": "50.00", "payment_method": { "id": "pix", "type": "bank_transfer" } } ] } }'
El valor APRO para el campo payer.first_name es el que determina que esta solicitud predefinida devuelva como respuesta una order creada y con status action_required, tal como se muestra a continuación. Posteriormente, el estado del pago pasará automáticamente a aprobado.
json{ "id": "ORD01JP84C939T20S0P1DN382FQ6K", "type": "online", "processing_mode": "automatic", "external_reference": "ext_ref_1234", "total_amount": "50.00", "country_code": "BRA", "user_id": "123456", "status": "action_required", "status_detail": "waiting_transfer", "capture_mode": "automatic", "created_date": "2025-03-13T16:11:10.826Z", "last_updated_date": "2025-03-13T16:11:11.736Z", "integration_data": { "application_id": "123456789" }, "transactions": { "payments": [ { "id": "PAY01JP84C939T20S0P1DN6FCMWQC", "amount": "50.00", "reference_id": "0002gw9x2v", "status": "action_required", "status_detail": "waiting_transfer", "payment_method": { "id": "pix", "type": "bank_transfer", "ticket_url": "https://www.mercadopago.com.br/sandbox/payments/104669748043/ticket?caller_id=1985141462&hash=1eff4445-4454-4308-a6b0-d2a1651ca44f", "qr_code": "00020126580014br.gov.bcb.pix0136b76aa9c2-2ec4-4110-954e-ebfe34f05b615204000053039865406200.005802BR5918TESTUSER20543760926009Sao Paulo62250521mpqrinter1046697480436304B70B", "qr_code_base64": "" } } ] } }
Por último, para verificar si la order de prueba fue creada 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 Pix como medio de pago estará completa y podrás, o bien continuar probando otros medios de pago integrados, o bien salir a producción.