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 realizar estas pruebas, envía la siguiente solicitud al endpoint /v1/ordersAPI, junto con el 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..

curl
Copiar
curl --request POST \
  --url https://api.mercadopago.com/v1/orders \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "online",
  "external_reference": "ext_ref_1234",
  "total_amount": "200.00",
  "payer": {
    "email": "test@testuser.com",
    "first_name": "APRO"
  },
  "transactions": {
    "payments": [
      {
        "amount": "200.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
Copiar
{
  "id": "ORD01JP84C939T20S0P1DN382FQ6K",
  "type": "online",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "200.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": "200.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, 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 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.