Yape

Para recibir pagos, es necesario agregar en el frontend un formulario que capture el número de celular y el OTP que el comprador genera en la aplicación Yape.

Si ya tienes un desarrollo que incluye un formulario de pago propio, asegúrate de incluir Yape entre las opciones de pago que deseas ofrecer, como se indica a continuación, y continúa con el paso Crear token Yape.

En caso de que aún no tengas un formulario de pago, agrega el modelo a continuación a tu proyecto e incluye el identificador de Yape como opción a ser ofrecida.

html
<form id="form-checkout" action="/process_payment" method="post">
  <div>
    <label for="payerPhone">Número de celular</label>
    <input id="form-checkout__payerPhone" name="payerPhone" type="text" />
  </div>
  <div>
    <label for="payerOTP">OTP</label>
    <input id="form-checkout__payerOTP" name="payerOTP" type="text" />
  </div>
  <div>
    <button type="submit">Pagar con Yape</button>
  </div>
</form>

El token Yape se crea a partir del número de celular y del código OTP (One-Time Password) informados en la solicitud, lo que aumenta la seguridad durante el flujo de pago. Una vez que el token es utilizado en una compra determinada, este es descartado, siendo necesaria la creación de uno nuevo para futuras compras.

Puedes crearlo con MercadoPago.js o mediante una llamada directa a la API.

javascript
const form = document.getElementById("form-checkout");

form.addEventListener("submit", async (event) => {
  event.preventDefault();

  const otp = document.getElementById("form-checkout__payerOTP").value;
  const phoneNumber = document.getElementById("form-checkout__payerPhone").value;
  const yape = mp.yape({ otp, phoneNumber });
  const yapeToken = await yape.create();

  // Envía yapeToken.id a tu servidor para crear la order.
});

El envío del pago debe realizarse mediante la creación de una order que contenga la transacción de pago asociada.

Para eso, envía una solicitud con tu Access Token de pruebaClave privada de la aplicación creada en Mercado Pago, utilizada en el backend. Accede a ella en Tus integraciones > Datos de integración > Pruebas > Credenciales de prueba. El Access Token de prueba comienza con el prefijo `APP_USR`. y los parámetros indicados a continuación al endpoint /v1/ordersPOST.

curl
curl --location --request POST 'https://api.mercadopago.com/v1/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--data-raw '{
  "type": "online",
  "external_reference": "ext_ref_1234",
  "processing_mode": "automatic",
  "total_amount": "100.00",
  "payer": {
    "email": "test_user_pe@testuser.com",
    "entity_type": "individual",
    "identification": {
      "type": "DNI",
      "number": "12345678"
    },
    "phone": {
      "area_code": "51",
      "number": "987654321"
    }
  },
  "transactions": {
    "payments": [
      {
        "amount": "100.00",
        "payment_method": {
          "id": "yape",
          "type": "debit_card",
          "token": "{{YOUR_YAPE_TOKEN}}"
        }
      }
    ]
  }
}'

Consulta en la tabla a continuación las descripciones de los parámetros que son obligatorios en la solicitud y de aquellos que, aunque sean opcionales, tienen alguna particularidad importante de destacar.

Al crear la order con éxito, recibirás una respuesta con status: processed y status_detail: accredited, indicando que el pago fue aprobado.

json
{
  "id": "ORDPE01EXAMPLEPE1234NCAKKBF68N64S",
  "type": "online",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "100.00",
  "total_paid_amount": "100.00",
  "country_code": "PER",
  "user_id": "1234567890",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "automatic_async",
  "currency": "PEN",
  "created_date": "2026-07-29T21:03:42.252Z",
  "last_updated_date": "2026-07-29T21:03:43.985Z",
  "integration_data": {
    "application_id": "1234567890123456"
  },
  "transactions": {
    "payments": [
      {
        "id": "PAYPE01EXAMPLEPE1234BSAR5ZWXX5YZG",
        "reference_id": "1234567890",
        "amount": "100.00",
        "paid_amount": "100.00",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "yape",
          "type": "debit_card"
        }
      }
    ]
  }
}

Como el Yape se procesa de forma síncrona cuando la order se crea en modo automático, no hay redireccionamiento del comprador. Entre los parámetros devueltos, se destacan los indicados en la tabla a continuación.

Dependiendo del modo en que se cree la order (automático o manual), un pago con Yape puede procesarse de dos formas distintas y, en consecuencia, su cancelación también. Consulta a continuación cómo proceder en cada una de las situaciones:

• Modo automático: la order se crea en modo automático y el pago con Yape se procesa de forma síncrona (status=processed). Con esto, la respuesta a la creación de la order ya traerá el resultado final del pago, no siendo posible cancelarlo cuando es aprobado (status_detail=accredited). En ese caso, será necesario realizar un proceso de reembolso a través de una solicitud al endpoint de /v1/orders/{order_id}/refundPOST.
  
  
• Modo manual: la order se crea en modo manual y el procesamiento del pago requiere una etapa adicional (status=action_required) en el endpoint de Procesar orderPOST. En ese caso, antes de procesar el pago será posible cancelarlo a través de una solicitud al endpoint de /v1/orders/{order_id}/cancelPOST.

Para obtener más información, consulta la sección Reembolsos y cancelaciones.